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物 联 网 开发 从 入 门 到 实战 


Ф 实录 520 分 钟 、84 个 高 清 学 习 视 频 。 
® 42 个 全 真实 战 案例 ， 环 环 相 扣 ， 深 入 解析 Android 物 联网 开发 。 
党 从 内 核 分 析 到 接口 API 实 现 ， 完 整 再 现 一 个 个 经 典 物 联网 项 目的 开发 全 程 。 
党 教授 精髓 ， 精 讲 精 炼 。 赠 送 源码 ， 拿 来 就 用 。 


$ 15 个 Android 综 合 项 目 开 发 案例 
DVD 音 38 个 Android 应 用 开发 学 习 视频 


清华 大 学 出 版 社 


Android 物 联 网 开发 从 入 门 到 实战 


IAF KAA 编著 


清华 大 学 出 版 社 
北 京 


Wy # Ur 


本 书 内 容 分 为 5 篇 ， 共 计 17 章 ， 循 序 渐进 地 讲解 了 Android 物 联网 开发 的 基本 知识 。 本 书 从 获取 源码 和 搭建 应 用 
开发 环境 开始 讲 起 ， 依 次 讲解 了 基础 知识 篇 、 数 据 传输 篇 、 信 息 识别 篇 、 传 感 器 应 用 篇 和 技术 提高 篇 这 5 大 部 分 内 容 。 
在 讲解 每 一 个 知识 时 ， 都 遵循 了 理论 联系 实际 的 讲解 方式 ， 从 内 核 分 析 到 接口 API 实现 ， 再 到 实战 演练 ， 最 后 到 综合 实 
例 演练 ， 彻 底 剖析 了 物 联 网 项 目 开发 的 完整 实现 流程 。 本 书 几 乎 涵盖 了 当下 Android 物 联网 开发 的 绝 大 多 数 内 容 ， 讲 解 
方法 通俗 易 懂 并 且 详细 ， 不 但 适合 应 用 高 手 们 学 习 ， 也 特别 便于 初学 者 学 习 和 理解 。 

本 书 适合 Android 驱动 开发 者 、Linux 开发 人 员 、Android 物 联网 开发 人 员 、Android 爱好 者 、Android 源码 分 析 人 
DA. Android 应 用 开发 人 员 、Android 传感器 开发 人 员 、Android 智能 家 居 开 发 人 员 、Android 可 穿戴 设备 人 员 的 学 习 ， 
也 可 以 作为 相关 培训 学 校 和 大 专 院 校 相关 专业 的 教学 用 书 。 


本 书 封面 贴 有 清华 大 学 出 版 社 防伪 标签 ， 无 标签 者 不 得 销售 。 
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2007 11 月 5 日 ,谷歌 公司 宣布 基于 Linux 平台 的 开源 手机 操作 系统 Android 诞生 ， 该 平台 号 称 
是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 移动 软件 平台 。 本 书 将 和 广大 读者 一 起 领略 这 款 系统 的 神 
奇 之 处 。 


市 场 占 有 率 高 居 第 一 


截至 2014 年 9 H, Android 在 手机 市 场 上 的 占有 率 从 2013 年 的 68.8% 上 升 到 80%。 而 iOS WA 
2013 年 的 19.4% 下 降 到 15.5%，WP 系统 从 原来 的 2.7% 小 幅 上 升 到 3.6%。 

从 数据 上 来 看 ，Android 平台 占据 了 市 场 的 主导 地 位 ， 继 续 充 当 老 大 的 角色 。Android 市 场 的 占有 
率 增加 幅度 较 大 ，WP 市 场 小 幅 增长 ， 但 ios 却 有 所 下 降 。 就 目前 来 看 ， 智 能 手机 的 市 场 已 经 饱和 ， 
大 多 数 人 都 在 各 个 平台 间 转 换 。 而 就 在 这 样 一 个 市 场 上 ，Android 的 占有 率 还 增长 了 10% 左 右 ， 确 实 
不 易 。 


为 开发 人 员 提 供 了 成 长 的 “沃土 ” 


(1) 保证 开发 人 员 可 以 迅速 转型 到 Android 应 用 开发 

Android 应 用 程序 是 通过 Java 语言 开发 的 ， 只 要 具备 Java 开发 基础 ， 就 能 很 快 上 手 并 掌握 。 作 为 
单独 的 Android 应 用 开发 ， 对 Java 编程 门槛 的 要 求 并 不 高 ， 即 使 没有 编程 经 验 的 门外汉 ， 也 可 以 在 突 
击 学 习 Java 之 后 学 习 Android。 另 外 ，Android 完全 支持 2D. 3D 和 数据 库 ， 并 且 和 浏览 器 实现 了 集成 。 
所 以 通过 Android 平台 ， 程 序 员 可 以 迅速 、 高 效 地 开发 出 绚丽 多 彩 的 应 用 ， 例 如 常见 的 工具 软件 、 管 
理 软件 、 互 联网 软件 和 游戏 等 。 

(2) 定期 召开 奖金 丰厚 的 Android 开发 大 赛 

为 了 吸引 更 多 的 用 户 使 用 Android 开发 ， 已 经 成 功 举办 了 奖金 为 数 千 万 美元 的 开发 者 竞赛 ， 鼓 励 
开发 人 员 创建 出 创意 十 足 、 十 分 有 用 的 软件 。 这 种 大 赛 对 于 开发 人 员 来 说 ， 不 但 能 练习 自己 的 开发 水 
平 ， 并 且 高 额 的 奖金 也 是 学 员 们 学 习 的 动力 。 

(3) 开发 人 员 可 以 利用 自己 的 作品 赚钱 

为 了 能 让 Android 平台 吸引 更 多 的 关注 ， 谷 歌 提 供 了 一 个 专门 下 载 Android 应 用 的 门店 : Android 
Market, 地 址 是 https:/play.google.comystore。 在 这 个 门店 里 允许 开发 人 员 发 布 应 用 程序 , 也 允许 Android 
用 户 下 载 获取 自己 喜欢 的 程序 。 作 为 开发 者 ， 需 要 申请 开发 者 账号 ， 申 请 后 才能 将 自己 的 程序 上 传 到 
Android Market， 并 且 可 以 对 自己 的 软件 进行 定价 。 只 要 你 的 软件 程序 足够 吸引 人 ， 你 就 可 以 获得 很 好 
的 金钱 回报 。 这 样 实现 了 程序 员 学 习 和 赚钱 的 两 不 误 ， 所 以 吸引 了 更 多 开发 人 员 加 入 到 Android KF 
中 来 。 
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本 书 的 内 容 


Android 系统 从 诞生 到 现在 的 短 短 几 年 时 间 ， 凭 借 其 操作 易 用 性 和 开发 的 简洁 性 ， 赢 得 了 广大 用 户 
和 开发 者 的 支持 ， 成 为 市 场 占有 率 第 一 的 智能 设备 系统 。 本 书 内 容 分 为 5 篇 ， 共 计 17 章 ， 循 序 渐进 地 
讲解 了 Android 物 联网 开发 的 基本 知识 。 本 书 从 获取 源码 和 搭建 应 用 开发 环境 开始 讲 起 ， 依 次 讲解 了 
基础 知识 篇 、 数 据 传输 篇 、 信 息 识别 篇 、 传 感 器 应 用 篇 和 技术 提高 篇 5 部 分 内 容 。 在 讲解 每 一 个 知识 
时 ， 都 遵循 了 理论 联系 实际 的 讲解 方式 ， 从 内 核 分 析 到 接口 实现 ， 再 到 实战 演练 ， 最 后 到 综合 实例 演 
练 ， 彻 底 剖 析 了 物 联 网 开发 的 完整 实现 流程 。 本 书 几 乎 涵盖 了 当下 Android 物 联网 开发 的 绝 大 多 数 内 
容 ， 讲 解 方法 通俗 易 懂 并 且 详细 ， 不 但 适合 应 用 高 手 们 学 习 ， 也 特别 便于 初学 者 学 习 并 理解 。 

本 书 适合 Android 驱动 开发 者 、Linux 开发 人 员 、Android 物 联网 开发 人 员 、Android 爱好 者 、Android 
源码 分 析 人 员 、Android 应 用 开发 人 员 、Android 传感器 开发 人 员 、Android 智能 家 居 开 发 人 员 、Android 
可 穿戴 设备 人 员 的 学 习 ， 也 可 以 作为 相关 培训 学 校 和 大 专 院 校 相关 专业 的 教学 用 书 。 


本 书 的 版 本 


Android 系统 自 2008 年 9 月 发 布 第 一 个 版 本 1.1 以 来 ， 截 至 2014 年 10 月 发 布 最 新 版 本 5.0, 一共 
存在 十 多 个 版 本 。 由 此 可 见 ，Android 系统 升级 频率 较 快 ， 一 年 之 中 最 少 有 两 个 新 版 本 诞生 。 如 果 过 于 
追求 新 版 本 ， 会 造成 力不从心 的 结果 。 所 以 在 此 建议 广大 读者 :“ 不 必 追 求 最 新 的 版 本 ， 我 们 只 需 关注 
最 流行 的 版 本 即 可 ”。 据 官方 统计 ， 截 至 2014 年 10 月 25 日 ， 占 据 前 3 位 的 版 本 分 别 是 Android 4.3、 
Android 4.4 和 Android 4.2， 其 实 这 3 个 版 本 的 区 别 并 不 是 很 大 ， 只 是 在 某 领域 的 细节 上 进行 了 更 新 。 
为 了 及 时 体验 Android 系统 的 最 新 功能 , 在 本 书 中 使 用 的 版 本 是 目前 (本 书 成 稿 时 ) 最 新 的 Android 5.0。 


本 书 特色 


本 书 内 容 十 分 丰富 ， 并 且 讲 解 细致 。 我 们 的 目标 是 通过 一 本 图 书 ， 提 供 多 本 图 书 的 价值 ， 读 者 可 
以 根据 自己 的 需要 有 选择 地 阅读 。 在 内 容 的 编写 上 ， 本 书 具 有 以 下 特色 。 

(o 内 容 全 面 ， 讲 解 细致 

本 书 几 乎 涵盖 了 Android 物 联网 开发 所 需要 的 主要 知识 点 ， 详 细 讲解 了 每 一 个 典型 物 联网 项 目的 
实现 过 程 和 具体 移植 方法 。 每 一 个 知识 点 都 力求 用 详实 和 易 懂 的 语言 展现 在 读者 面前 。 

(20 遵循 合理 的 主线 进行 讲解 

为 了 使 广大 读者 彻底 弄 清楚 Android 物 联网 开发 的 各 个 知识 点 ， 在 讲解 每 一 个 知识 点 时 ， 从 Linux 
内 核 开始 讲 起 ， 依 次 剖析 了 底层 架构 、API 接口 连接 和 具体 应 用 的 知识 。 遵 循 了 从 底层 到 顶层 ， 实 现 
了 Android 物 联网 开发 大 揭秘 的 目标 。 

(3) 章节 独立 ， 自 由 阅读 

本 书 中 的 每 一 章 内 容 都 可 以 独自 成 书 ， 读 者 既 可 以 按照 本 书 编排 的 章节 顺序 进行 学 习 ， 也 可 以 根 
据 自己 的 需求 对 某 一 章节 进行 针对 性 的 学 习 ， 并 且 和 传统 古板 的 计算 机 书籍 相 比 ， 阅 读本 书 会 带 来 很 
大 的 快乐 。 
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(4) 实例 典型 ， 实 用 性 强 

本 书 讲解 了 现实 中 最 典型 的 Android 物 联 网 项 目的 实现 方法 和 架构 技巧 ， 这 些 经 典 应 用 都 是 在 商 
业 项 目 中 最 需要 的 部 分 。 读 者 可 以 直接 将 本 书 中 的 知识 灵活 运用 ， 应 用 到 自己 的 项 目 中 ， 实 现 无 乡 
对 接 。 

(5) 超 值 学 习 光 盘 

本 书 光盘 配备 了 丰富 的 学 习 资 源 ， 除 源 代 码 、PPT 之 外 ， 还 实录 了 84 个 高 清 学 习 视 频 ， 既 有 实用 
的 知识 点 讲解 视频 ， 又 有 详细 的 实例 开发 视频 ， 全 面 、 深 入 、 细 致 地 解析 Android 物 联网 开发 的 方 方 
面 面 。 除 此 以 外 ， 本 书 额 外 赠送 了 38 个 Android 应 用 开发 学 习 视频 ， 以 及 15 个 Android 应 用 开发 综合 
案例 ， 包 括 仿 小 米 录音 机 、 音 乐 播放 器 、 跟 踪 定 位 系统 、 仿 陌 陌 交友 系统 、 手 势 音乐 播放 器 、 智 能 家 
居 系 统 、 湿 度 测 试 仪 、 象 棋 游戏 、 抢 滩 登 陆游 戏 、 九 宫 格 数 独 游戏 、 健 康 饮 食 系 统 、 仓 库 管 理 系统 、 
个 人 财务 系统 、 仿 去 哪儿 酒店 预定 系统 、 仿 开心 网 客户 端 等 。 通 过 这 些 附 配 资源 ， 读 者 的 学 习 过 程 会 
更 加 方便 、 快 捷 。 

(6) 配备 Eclipse 和 Android Studio 双环 境 源码 

自 Android 6.0 以 来 ， 谷 歌 公司 不 再 对 Eclipse 环境 提供 技术 支持 ， 而 是 主推 Android Studio 环境 ， 
因此 本 书 为 广大 读者 提供 了 详细 的 Android Studio 学 习 教程 ， 以 及 Eclispe、Android Studio 双重 环境 下 
的 源码 ， 读 者 可 登录 本 书 的 服务 论坛 http://www.chubanbook.com 进行 下 载 。 


读者 对 象 


初学 Android 编程 的 自学 者 。 
Linux 开发 人 员 。 
大 中 专 院 校 的 老师 和 学 生 。 
毕业 设计 的 学 生 。 
Android 编程 爱好 者 。 
相关 培训 机 构 的 老师 和 学 员 。 
从 事 Android 开发 的 程序 员 。 

参与 本 书 编写 的 人 员 还 有 周秀 、 付 松柏 、 邓 才 兵 、 钟 世 礼 、 谭 贞 军 、 张 加 春 、 王 教 明 、 万 春 潮 、 
郭 慧玲 、 侯 恩 静 、 程 娟 、 王 文忠 、 陈 强 、 何 子夜 、 李 天 祥 、 周 锐 、 朱 桂 英 、 张 元 亮 、 张 韶 青 、 秦 丹 枫 。 
本 团队 在 编写 的 过 程 中 ， 得 到 了 清华 大 学 出 版 社工 作 人 员 的 大 力 支持 ， 正 是 各 位 编辑 的 求实 、 耐 心 和 
效率 ， 才 使 得 本 书 在 这 么 短 的 时 间 内 出 版 。 另 外 也 十 分 感谢 我 们 的 家 人 ， 在 我 们 写作 的 时 候 给 予 的 巨 
大 支持 。 

由 于 编者 水 平 有 限 ， 如 有 丝 漏 和 不 尽 如 人意 之 处 ， 诚 请 读者 提出 意见 或 建议 ， 以 便 修订 并 使 之 更 至 完 
善 。 另 外 ， 我 们 提供 了 售后 支持 网 站 Chttp:/www.chubanbook.com/) 和 QQ 群 (192153124)， 读 者 朋友 如 
有 疑问 可 以 在 此 提出 ， 一 定 会 得 到 满意 的 答复 。 
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第 1 章 Android 系统 介绍 


2007 年 ,Google 公司 推出 了 一 款 无 与 伦比 的 移动 智能 设备 系统 一 Android, 这 是 一 种 建立 在 Linux 
基础 之 上 的 为 手机 、 平 板 等 移动 设备 提供 的 软件 解决 方案 。 截 至 2013 年 ， 根 据 知 名 IDC 公司 的 统计 
Android 系统 在 世界 智能 手机 发 货 量 中 占据 75% 的 份额 ， 已 经 成 为 了 当今 最 受 欢 迎 的 智能 设备 系统 之 
一 。 本 章 将 引领 读者 一 起 来 了 解 Android 系统 的 发 展 历程 和 背景 ， 充 分 体验 这 款 操作 系统 的 成 功 之 处 。 


1.1 纵览 智能 设备 系统 


= 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 1 章 \ 纵 览 智能 设备 系统 .avi 

在 当今 市 面 中 有 很 多 智能 手机 系统 ， 在 Android 推出 之 前 ， 智 能 手机 系统 领域 塞 班 、 人 苹果、 微软 
互 不 相让 ， 呈 三 足 易 立 之 势 。 除 此 之 外 ， 还 有 占 份 额 较 小 的 PDA、 黑 莓 等 。 本 节 将 一 一 介绍 这 些 智 能 
手机 系统 。 


1.1.1 Symbian (HF) 


Symbian 作为 昔日 智能 手机 的 王者 ， 在 2005 一 2010 年 曾 一 度 盛行 ， 街 上 大 大 小 小 拿 的 很 多 都 是 诺 
基 亚 的 Symbian 手机 ，N70 一 N73 一 N78 一 N97， 诺 基 亚 N 系列 曾经 被 称 为 “N= 无 限 大 ”的 手机 。 对 硬 
件 的 水 平 要 求 低 ， 操 作 简单 ， 省 电 ， 软 件 众多 是 Symbian 系统 手机 的 重要 特点 。 

在 国内 软件 开发 市 场 内 ， 基 本 每 一 个 软件 都 会 有 对 应 的 塞 班 手机 版 本 。 而 塞 班 开发 之 初 的 目标 是 
要 保证 在 较 低 资 源 的 设备 上 能 长 时 间 稳定 可 靠 地 运行 ， 这 导致 了 塞 班 的 应 用 程序 开发 有 着 较为 陡峭 的 
学 习 曲 线 ， 开 发 成 本 较 高 。 但 是 程序 的 运行 效率 很 高 。 例 如 5800 的 128MB 的 RAM， 后 台 可 以 同时 运 
行 十 几 个 程序 而 保持 操作 流畅 (多 任务 功能 是 特别 强大 的 ), 即使 几 天 不 关机 它 的 剩余 内 存 也 能 保持 稳定 。 

虽然 在 Android, iOS 的 围攻 之 下 ， 诺 基 亚 推出 了 塞 班 ^3 系统 ,甚至 依然 为 其 更 新 (Symbian Anna, 
Symbian Belle)， 从 外 在 的 用 户 界面 到 内 在 的 功能 特性 都 有 了 显著 提升 ， 例 如 可 自由 定制 的 全 新 窗 体 部 
件 、 更 多 主屏 、 全 新 下 拉 式 菜单 等 。 

由 于 对 新 兴 的 社交 网 络 和 Web 2.0 内 容 支 持 欠 佳 ， 塞 班 占 智能 手机 的 市 场 份额 日 益 萎 缩 。2010 年 
末 ， 其 市 场 占有 量 已 被 Android 超过 。 自 2009 年 底 开 始 ， 包 括 摩托 罗拉 、 三 星 电子 、LG、 索 尼 爱 立信 
等 各 大 厂商 纷纷 宣布 终止 塞 班 平台 的 研发 ， 转 而 投入 Android 领域 。2011 年 初 ， 诺 基 亚 宣布 将 与 微软 
成 立 战略 联盟 ， 推 出 基于 Windows Phone 的 智能 手机 ， 从 而 在 事实 上 放弃 了 经 营 多 年 的 塞 班 ， 塞 班 退 
市 已 成 定局 。 


1.1.2. Android (es) 


Android 一 词 最 早出 现 于 法 国 作家 利 尔 亚当 (Auguste Villiers de l'Isle-Adam) 在 1886 年 发 表 的 科幻 
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小 说 《未 来 夏娃 》(Z'eve future) 中 。 他 将 外 表 像 人 的 机 器 起 名 为 Androids 

从 2008 年 НТС 和 Google 联手 推出 第 一 台 Android 手机 G1 开始 , 到 2014 年 10 月 15 日 (美国 
太平 洋 时 间 )，Google 公司 发 布 全 新 Android 操作 系统 Android 5.0 为 止 ，Android 系统 经 过 了 多 个 版 本 
的 发 展 。 从 2011 年 第 一 季度 开始 , Android 在 全 球 的 市 场 份额 首次 超过 塞 班 系统 , 跃 居 全 球 第 一 。2014 
年 8 月 15 日 消息 ， 根 据 IDC 发 布 的 2014 年 第 二 季度 智能 手机 市 场 的 最 新 数据 显示 ， 苹 果 105 和 谷歌 
Android 两 大 系统 平台 继续 领跑 , Android 阵营 增长 则 更 惊人 , 达到 了 33.3%, 出 货 量 达到 了 2.553 亿 台 。 
Android 系统 的 市 场 份额 得 到 了 提高 , 从 2013 年 第 二 季度 的 79.6% 增 长 到 了 2014 年 第 二 季度 的 84.7%。 
具体 信息 如 图 1-1 所 示 。 


Top Five Smartphone Operating Systems, Worldwide Shipments, and 
Market Share, 201402 (Units in Millions) - IDC/Applelnsider 
922014 022014 02 2013 022013 Year- 
Shipment Market Shipment Market Over-Year 
Volume Share Volume Share Growth 


Operating System 

Android 2553 8479 1915 796% 333% 
ios 352 11.7% 312 130% 127% 
Windows Phone 74 25% 82 34% -94% 
BlackBorry 15 05% 67 28% 780% 
Others 19 06% 29 12%» -322% 
тога! 301.3 1000% 2405 100.0% 25.3% 


图 1-1 2014 年 8 月 智能 手机 平台 调查 表 


由 此 可 见 ，Android 系统 的 市 场 占有 率 位 居 第 一 ， 并 且 毫 无 压力 。Android 机 型 数量 庞大 ， 简 单 易 
用 ,相当 自由 的 系统 能 让 厂商 和 客户 轻松 地 定制 各 种 各 样 的 ROM， 定 制 各 种 桌面 部 件 和 主题 风格 。 简 
单 而 华丽 的 界面 得 到 广大 客户 的 认可 ， 对 手机 进行 刷机 也 是 不 少 Android 用 户 所 津津 乐 道 的 事情 。 

可 惜 Android 版 本 数量 较 多 , 市 面 上 同时 存在 着 1.6、2.0、2.1、2.2、2.3、4.4.2 等 各 种 版 本 的 Android 
系统 手机 ， 应 用 软件 和 各 版 本 系统 的 兼容 性 对 程序 开发 人 员 是 一 种 很 大 的 挑战 。 同 时 由 于 开发 门槛 低 ， 
导致 应 用 数量 虽然 很 多 ， 但 是 应 用 质量 参差 不 齐 ， 甚 至 出 现 不 少 恶意 软 件 ， 导 致 一 些 用 户 受到 损失 。 
同时 Android 没有 对 各 厂商 在 硬件 上 进行 限制 ， 导 致 一 些 用 户 在 低 端 机 型 上 体验 不 佳 。 另 一 方面 ， 因 
为 Android 的 应 用 主要 使 用 Java 语言 开发 , 其 运行 效率 和 硬件 消耗 一 直 是 其 他 手机 用 户 所 诉 病 的 地 方 。 


1.1.3 iOS 〈 苹 果 系 统 ) 


iOS 作为 苹果 移动 设备 iPhone 和 iPad 的 操作 系统 ， 在 App Store 的 推动 之 下 ， 成 为 了 世界 上 引领 
潮流 的 操作 系统 之 一 。 原 本 这 个 系统 名 为 “iPhone OS”， 直 到 2010 年 6 月 7 日 WWDC 大 会 上 宣布 改 
ZAI “ios”. ios 用 户 操 作 界面 的 最 大 特性 是 可 以 使 用 多 点 触 控 的 方式 完成 所 有 操作 。 控 制 方法 包括 
滑动 、 轻 触 开 关 及 按键 。 与 系统 交互 包括 滑动 (Swiping)、 轻 按 (Tapping)、 挤 压 〈Pinching， 通 常用 
于 缩小 ) 及 反 向 挤 压 (Reverse Pinching or unpinching， 通 常用 于 放大 )。 此 外 ， 通 过 其 自 带 的 加 速 器 ， 
可 以 令 其 旋转 设备 时 改变 其 y 轴 以 令 屏幕 改 变 方向 ， 这 样 的 设计 令 iPhone 更 便于 使 用 。 

Jg iPhone OS 1.0: 内 置 于 iPhone 一 代 手 机 中 ， 借 助 iPhone 流畅 的 触摸 屏幕 ，iPhone OS 给 

用 户 带 来 了 极为 优秀 的 使 用 体验 ， 相 比 当时 的 手机 可 以 用 惊艳 来 形容 。 

iPhone OS 2.0: 随 着 iPhone 3G 的 发 布 ，App Store 诞生 。App Store 为 第 三 方 软件 的 提供 者 提 
供 了 一 个 方便 而 又 高 效 的 软件 销售 平台 ， 在 软件 开发 者 与 最 终 用 户 之 间架 起 了 一 座 沟通 与 销 
售 的 桥梁 ， 从 而 极 大 地 丰富 了 iPhone 手机 应 用 功能 。 
iPhone OS 3.0: iPhone 3GS 开始 支持 复制 粘贴 。 
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105 4: 在 iPhone 4 推出 时 ， 苹 果 决 定 将 原来 iPhone OS 系统 重新 定名 为 “iOS”， 并 发 布 新 一 
代 操 作 系统 “ioOS A". 在 这 个 版 本 中 , 开始 正式 支持 多 任务 功能 ,通过 双击 HOME 键 实现 切换 。 

105 5: 加 入 了 Siri 语音 操作 助手 功能 ， 用 户 可 以 与 手机 实现 语言 上 的 人 机 交互 ， 该 功能 可 以 
实现 对 用 户 的 语音 识别 ， 完 成 一 些 较为 复杂 的 操作 ， 使 用 Siri 来 实现 查询 天 气 、 进 行 导航 、 
询问 时 间 、 设 定 闹钟 、 查 询 股票 甚至 发 送 短信 等 功能 ， 方 便 了 用 户 的 使 用 。 

从 最 初 的 iPhone OS， 演 变 至 最 新 的 iOS AS, 105 成 为 了 苹果 新 的 移动 设备 操作 系统 ， 横 跨 iPod 
Touch、iPad、iPhone， 成 为 苹果 最 强大 的 操作 系统 。 甚 至 新 一 代 的 Mac OS X Lion 也 借鉴 了 ios 系统 
的 一 些 设计 ， 可 以 说 ios 是 苹果 的 又 一 个 成 功 的 操作 系统 ， 能 给 用 户 带 来 极 佳 的 使 用 体验 。 

优秀 系统 设计 以 及 严格 的 App Store, iOS 作为 应 用 数量 最 多 的 移动 设备 操作 系统 ， 加 上 强大 的 硬 
件 支持 以 及 iOS 5 内 置 的 Siri 语音 助手 ， 无 疑 使 得 用 户 体验 得 到 更 大 的 提升 ， 感 受 科技 带 来 的 好 处 。 


1.1.4 Windows Phone (微软 系 统 ) 


早 在 2004 年 时 , 微软 就 开始 以 “Photon” 的 计划 代号 开始 研发 Windows Mobile 的 一 个 重要 版 本 更 
新 。 直 到 2008 年 ， 在 iOS 和 Android 的 巨大 冲击 之 下 ， 微 软 重新 组 织 了 Windows Mobile 的 小 组 ， 并 
继续 开发 一 个 新 的 移动 操作 系统 。 

Windows Phone， 简 称 WP， 是 微软 发 布 的 一 款 手机 操作 系统 ， 它 将 微软 旗下 的 Xbox Live 游戏 、 
Xbox Music 音乐 与 独特 的 视频 体验 集成 至 手机 中 。 微 软 公 司 于 2010 年 10 月 11 日 晚上 9 点 30 分 正式 
发 布 了 智能 手机 操作 系统 Windows Phone， 并 将 其 使 用 接口 称 为 “Modem ”接口 。2011 年 2 月 ,“ 诺 基 
亚 ” 与 微软 达成 全 球 战略 同盟 并 深度 合作 共同 研发 。2011 年 9 月 27 日 ， 微 软 发 布 Windows Phone 7.5. 
2012 年 6 月 21 日 ， 微 软 正 式 发 布 Windows Phone 8， 采 用 和 Windows 8 相同 的 Windows NT 内 核 ， 同 
时 也 针对 市 场 的 Windows Phone 7.5 发 布 Windows Phone 7.8。 现 有 Windows Phone 7 手机 都 将 无 法 升级 
至 Windows Phone 8。 

Windows Phone 具有 桌面 定制 、 图 标 拖 忠 、 滑 动 控制 等 一 系列 前 卫 的 操作 体验 。 其 主屏 幕 通过 提 
供 类 似 仪 表盘 的 体验 来 显示 新 的 电子 邮件 、 短 信 、 未 接 来 电 、 日 历 约会 等 ， 对 重要 信息 保持 时 刻 更 新 。 
它 还 包括 一 个 增强 的 触摸 屏 界 面 ， 更 方便 手指 操作 ;以 及 一 个 最 新 版 本 的 IE Mobile 浏览 器 一 一 该 浏览 
器 在 一 项 由 微软 赞助 的 第 三 方 调查 研究 中 ， 和 参与 调研 的 其 他 浏览 器 和 手机 相 比 ， 可 以 执行 指定 任务 
的 比例 超过 48%。 很 容易 看 出 微软 在 用 户 操作 体验 上 所 做 出 的 努力 ， 而 史 蒂 夫 。 鲍 尔 默 也 表示 :“ 全 新 
的 Windows 手机 把 网 络 、 个 人 电脑 和 手机 的 优势 集 于 一 身 ， 让 人 们 可 以 随时 随地 享受 到 想 要 的 体验 ”。 

Windows Phone 力图 打破 人 们 与 信息 和 应 用 之 间 的 隔 头 ， 提 供 适 用 于 人 们 包括 工作 和 娱乐 在 内 完 
整 生活 的 方方面面 ， 最 优秀 的 端 到 端 体验 。 


1.1.5 BlackBerry OS (222%) 


BlackBerry 系统 ， 即 黑莓 系统 ， 是 加 拿 大 Research In Motion (RIM) 公司 推出 的 一 种 无 线 手持 邮 
件 解决 终端 设备 的 操作 系统 ， 由 RIM 自主 开发 。 它 和 其 他 手机 终端 使 用 的 Symbian. Windows Mobile. 
IOS 等 操作 系统 有 所 不 同 ，BlackBerry 系统 的 加 密 性 能 更 强 、 更 安全 。 

安装 有 BlackBerry 系统 的 黑莓 机 ， 指 的 不 单单 只 是 一 台 手 机 ， 而 是 由 RM 公司 所 推出 ,包含 服务 
器 〈 邮 件 设 定 )、 软 件 〈 操 作 接口 ) 以 及 终端 〈 手 机 ) 大 类 别 的 Push Май 实时 电子 邮件 服务 。 

“黑莓 ”移动 邮件 设备 基于 双向 寻 呼 技术 。 该 设备 与 RIM 公司 的 服务 器 相 结合 ， 依 赖 于 特定 的 服 
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务 器 软件 和 终端 ， 兼 容 现 有 的 无 线 数据 链 路 ， 实 现 了 遍及 北美 、 随 时 随地 收发 电子 邮件 的 梦想 。 这 种 
装置 并 不 以 奇妙 的 图 片 和 彩色 屏幕 夺 人 耳目 ， 甚 至 不 带 发 声 器 。“9。11” 事 件 之 后 ， 由 于 BlackBerry 
及 时 传递 了 灾难 现场 的 信息 ， 而 在 美国 掀起 了 拥有 一 部 BlackBerry 终端 的 热潮 。 

黑莓 赖 以 成 功 的 最 重要 原则 一 一 针对 高 级 白领 和 企业 人 士 ， 提 供 企业 移动 办 公 的 一 体 化 解决 方案 。 
企业 有 大 量 的 信息 需要 及 时 处 理 ， 出 差 在 外 时 ， 也 需要 一 个 无 线 的 可 移动 的 办 公设 备 。 企 业 只 要 装 一 
个 移动 网 关 ， 一 个 软件 系统 ， 用 手机 的 平台 实现 无 颖 链接， 无 论 何 时 何 地 ， 员 工 都 可 以 用 手机 进行 办 
公 。 它 最 大 的 方便 之 处 是 提供 了 邮件 的 推送 功能 : 即 由 邮件 服务 器 主动 将 收 到 的 邮件 推送 到 用 户 的 手 
持 设备 上 ， 而 不 需要 用 户 频繁 地 连接 网 络 查看 是 否 有 新 邮件 。 

黑莓 系统 稳定 性 非常 优秀 ， 其 独特 定位 也 深 得 商务 人 士 所 青睐 。 可 是 也 因此 在 大 众 市 场 上 得 不 到 
优势 ， 国 内 用 户 和 应 用 资源 也 较 少 。 
背景 说 明 : 

(1) 2010 年 9 月 ,诺基亚 宣布 将 从 2011 年 4 月 起 从 Symbian 基金 会 Symbian Foundation ) 手中 
收回 Symbian 操作 系统 控制 权 。 由 此 看 来 ， 诺 基 亚 在 2008 年 全 资 收购 塞 班 公司 之 后 希望 继续 扩大 塞 班 
影响 力 的 愿望 并 没有 实现 。 

(2) 在 苹果 和 Android 的 强大 市 场 攻势 下 ， 诺 基 亚 在 2011 年 2 月 11 日 宣布 与 微软 达成 广泛 战略 
合作 关系 ， 并 将 Windows Phone 作为 其 主要 的 智能 手机 操作 系统 。 这 家 芬兰 手机 巨头 试图 通过 结盟 捏 
HAH. 

(3) 2011 年 8 月 15 日 ,谷歌 和 摩托 罗拉 移动 公司 共同 宣布 ， 谷 歌 将 以 每 股 40.00 美元 现金 收购 
摩托 罗拉 移动 ， 总 额 约 125 亿美 元 ， 相 比 摩托 罗拉 移动 股份 的 收盘 价 溢价 了 63%， 双 方 董事 会 都 已 全 
票 通过 该 交易 。 谷 歌 CEO 拉 里 。 佩 奇 表示 ， 摩 托 罗拉 移动 完全 专注 于 Android 系统 ， 收 购 摩托 罗拉 移 
动 之 后 ， 将 增强 整个 Android 生态 系统 。 佩 奇 同时 表示 ，Android 将 继续 开源 ， 收 购 的 一 个 目的 是 为 了 
获得 专利 。 

(4) 2013 年 9 月 3 日， 微软 公司 宣布 将 以 37.9 亿 欧 元 的 价格 收购 诺基亚 的 设备 和 服务 部 门 ， 同 
时 还 将 以 16.5 亿 欧 元 的 价格 收购 诺基亚 的 相关 技术 专利 ， 本 次 交易 总 额 达到 54.4 亿 欧元 ， 其 中 有 3.2 
万 名 员工 将 从 诺基亚 转 入 微软 ， 整 笔 交易 预计 将 于 2014 年 第 一 季度 完成 。 

(5) 2013 年 9 月 24 日 消息 ， 黑 莓 表示 已 经 与 由 Fairfax Financial Holdings 主导 的 财团 达成 交易 ， 
准备 以 47 亿美 元 出 售 ， 但 是 后 来 没有 任何 爆炸 性 消息 发 布 。 
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ERU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 工 章 \ 分 析 Android 成 功 的 秘诀 .avi 
从 2007 年 诞生 ， 到 2014 年 占据 市 场 80% 的 份额 ， 为 什么 Android 系统 能 够 在 这 么 短 的 时 间 内 成 
为 移动 智能 设备 市 场 占有 率 的 第 一 名 ? 本 节 将 从 4 个 方面 来 为 读者 解答 这 个 问题 。 


1.21 强 有 力 的 业界 支持 


Android 系统 基于 Linux 内 核 ， 是 一 款 开源 的 手机 操作 系统 。 正 是 因为 如 此 ， 在 Android HIRI FE 
头角 之 后 ， 各 大 手机 厂商 和 电信 部 门 纷纷 加 入 到 了 Android 联盟 当中 。Android 联盟 由 业界 内 的 世界 级 
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企业 组 成 ， 主 要 成 员 包 括 中 国 和 移动、 摩托罗拉、 高 通 、T-Mobile、 三 星 、LG、HTC 等 在 内 的 30 多 家 
技术 和 无 线 应 用 的 领军 企业 。Android 通过 与 运营 商 、 设 备 制造 商 、 开 发 商 和 其 他 有 关 各 方 结 成 深层 次 
的 合作 伙伴 关系 ， 和 希望 借助 建立 标准 化 、 开 放 式 的 移动 电话 软件 平台 ， 在 移动 产业 内 形成 一 个 开放 式 
的 生态 系统 。 


122 ”研发 阵容 强大 


Android 的 研发 队伍 阵容 强大 ， 包 括 摩托 罗拉 、Google、HTC (宏达电 子 )、PHILIPS、T-Mobile、 
高 通 、 魅 族 、 三 星 、LG 以 及 中 国 移动 在 内 的 34 家 企业 ， 这 些 一 个 个 响亮 的 名 字 都 在 业界 内 堪 称 大 化 。 
他 们 都 将 基于 该 平台 开发 手机 的 新 型 业务 ， 应 用 之 间 的 通用 性 和 互联 性 将 在 最 大 程度 上 得 到 保持 。 无 
论 是 从 硬件 到 软件 ， 还 是 到 电信 服务 商 ，Android 从 一 开始 便 成 为 了 业界 内 的 宠儿 ， 被 当 作 重 点 新 秀 而 
培养 。 这样 Android 系统 在 强大 的 开发 团队 的 培育 和 呵护 下 ， 最 终 顺 利 地 功成名就 ， 成 为 了 一 方 霸主 。 


123 ”为 开发 人 员 “ 精 心 定制 ” 


Google 公司 一 直 视 程序 员 为 前 进 动力 的 源泉 ， 为 了 提高 程序 员 们 的 开发 积极 性 ， 不 但 为 开发 人 员 
提供 了 一 流 的 开发 装备 和 软件 服务 ， 而 且 还 提出 了 振奋 人 心 的 奖励 机 制 。 

(1) 保证 开发 人 员 可 以 迅速 转型 为 Android 应 用 开发 人 员 

Android 应 用 程序 是 通过 Java 语言 开发 的 ， 只 要 具备 Java 开发 基础 ， 就 能 很 快 地 上 手 并 掌握 。 作 
为 单独 的 Android 应 用 开发 ， 对 Java 编程 门槛 的 要 求 并 不 高 ， 即 使 没有 编程 经 验 的 门外汉 ， 也 可 以 在 
突击 学 习 Java 之 后 不 影响 学 习 Android。 另 外 ，Android 完全 支持 2D、3D 和 数据 库 ， 并 且 和 浏览 器 实 
现 了 集成 。 所 以 通过 Android 平台 ， 程 序 员 可 以 迅速 、 高 效 地 开发 出 绚丽 多 彩 的 应 用 ， 例 如 常见 的 工 
具 软 件 、 管 理 软件 、 互 联网 应 用 和 游戏 等 。 

(2) 定期 召开 奖金 丰厚 的 Android 开发 大 赛 

为 了 吸引 更 多 的 用 户 使 用 Android 开发 ， 已 经 成 功 举 办 了 奖金 为 数 千 万 美元 的 开发 者 竞赛 。 鼓 励 
开发 人 员 创建 出 创意 十 足 、 十 分 有 用 的 软件 。 对 于 开发 人 员 来 说 ， 这 种 大 赛 不 但 能 练习 自己 的 开发 水 
平 ， 并 且 高 额 的 奖金 也 是 学 员 们 学 习 的 动力 。 

(3) 开发 人 员 可 以 利用 自己 的 作品 赚钱 

为 了 能 让 Android 平台 吸引 更 多 的 关注 ， 谷 歌 提 供 了 一 个 专门 下 载 Android 应 用 的 门店 : Android 
Market, 地 址 是 https:/play.google.comystore。 在 这 个 门店 里 允许 开发 人 员 发 布 应 用 程序 , 也 允许 Android 
用 户 下 载 获取 自己 喜欢 的 程序 。 作 为 开发 者 ， 需 要 申请 开发 者 账号 ， 申 请 后 才能 将 自己 的 程序 上 传 到 
Android Market， 并 且 可 以 对 自己 的 软件 进行 定价 。 只 要 你 的 软件 程序 足够 吸引 人 ， 你 就 可 以 获得 很 好 
的 金钱 回报 。 这 样 实现 了 程序 员 学 习 和 赚钱 的 两 不 误 ， 所 以 吸引 了 更 多 开发 人 员 加 入 到 Android KE 
中 来 。 


1.24 开源 


Android 是 一 款 开 源 的 系统 ,开源 意味 着 对 开发 人 员 和 手机 厂商 来 说 是 完全 无 偿 免 费 使 用 的 。 正 是 
因为 这 一 原因 ， 所 以 吸引 了 全 世界 各 地 无 数 程序 员 的 热情 。 于 是 很 多 手机 厂商 都 纷纷 采用 Android (Е 
为 自己 产品 的 系统 ， 这 当然 也 包括 很 多 山寨 厂商 。 因 为 免费 所 以 降低 了 成 本 ， 因 此 提高 了 利润 。 而 对 
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13 剖析 Android 系统 架构 


EG 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 工 章 \ 剖 析 Android 系统 架构 .avi 

Android 系统 是 一 个 移动 设备 的 开发 平台 ， 其 软件 层次 结构 包括 操作 系统 (OS)、 中 间 件 
(MiddleWare) 和 应 用 程序 (Application)。 根 据 Android 的 软件 框图 ， 其 软件 层次 结构 自 下 而 上 分 为 
以 下 4 层 。 

(1) 操作 系统 层 (OS). 

(2) 各 种 库 (Libraries) 和 Android 运行 环境 (RunTime). 

(3) 应 用 程序 框架 (Application Framework). 

(4) 应 用 程序 (Application )。 

上 述 各 个 层 的 具体 结构 如 图 1-2 所 示 。 
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图 1-2 Android 操作 系统 的 组 件 结构 图 
本 节 将 详细 介绍 Android 操作 系统 的 基本 组 件 结构 方面 的 知识 。 


1.3.1 底层 操作 系统 层 (OS) 


因为 Android 源 于 Linux, 使 用 了 Linux 内 核 , 所 以 Android 使 用 Linux 2.6 作为 操作 系统 。Linux 2.6 
是 一 种 标准 的 技术 ，Linux 也 是 一 个 开放 的 操作 系统 。Android 对 操作 系统 的 使 用 包括 核心 和 驱动 程序 
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两 部 分 ，Android 的 Linux 核心 为 标准 的 Linux 2.6 内 核 ，Android 更 多 的 是 需要 一 些 与 移动 设备 相关 的 
驱动 程序 。 主 要 的 驱动 如 下 。 
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1.3.2 
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显示 驱动 (Display Driver): 是 常用 的 基于 Linux 的 帧 缓冲 (Frame Buffer) 驱动 。 

Flash 内 存 驱 动 (Flash Memory Driver): 是 基于 MTD 的 Flash 驱动 程序 。 

照相 机 驱动 (Camera Driver): 常用 基于 Linux 的 VAL. (Video for Linux) 驱动 。 

音频 驱动 (Audio Driver): 常用 基于 ALSA (Advanced Linux Sound Architecture， 高 级 Linux 
音 体系 ) 驱动 。 

WiFi 4K) (Camera Driver): 基于 IEEE 802.11 标准 的 驱动 程序 。 

键盘 驱动 (KeyBoard Driver): 作为 输入 设备 的 键盘 驱动 。 

蓝牙 驱动 (Bluetooth Driver): 基于 IEEE 802.15.1 标准 的 无 线 传输 技术 。 

Binder IPC 驱动 : Andoid 一 个 特殊 的 驱动 程序 具有 单独 的 设备 节点 , 提供 进程 间 通 信 的 功能 。 

Power Management (能源 管 理 )， 用 于 管理 电池 电量 等 信息 。 


各 种 库 (Libraries) 和 Android 运行 环境 (RunTime) 


层次 对 应 一 般 嵌 入 式 系统 , 相当 于 中 间 件 层次 。 Android 的 本 层次 分 成 两 个 部 分 , 一 个 是 各 种 库 ， 


另 一 个 是 Android 运行 环境 。 本 层 的 内 容 大 多 是 使 用 C++ 实 现 的 ， 其 中 包含 了 如 下 所 示 的 各 种 库 。 
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CH: C 语言 的 标准 库 ， 也 是 系统 中 一 个 最 为 底层 的 库 ，C 库 通 过 Linux 的 系统 调用 来 实现 。 
多 媒体 框架 (Media Framework): 这 部 分 内 容 是 Android 多 媒体 的 核心 部 分 , 基于 PacketVideo 
( 即 PV) 的 OpenCORE, 从 功能 上 本 库 一 共 分 为 两 大 部 分 ,一 部 分 是 音频 ,视频 的 回放 (PlayBack )， 
另 一 部 分 则 是 音 视频 的 记录 (Recorder). 

SGL: 2D 图 像 引 擎 。 

SSL: 即 Secure Socket Layer 位 于 ТСРЛР 协议 与 各 种 应 用 层 协议 之 间 ， 为 数据 通信 提供 安全 

支持 。 

OpenGL ES: 提供 了 对 3D 的 支持 。 

界面 管理 工具 (Surface Management): 提供 了 管理 显示 子 系统 等 功能 。 

SQLite: 一 个 通用 的 嵌入 式 数 据 库 。 

WebKit: 网 络 浏览 器 的 核心 。 

FreeType: 位 图 和 矢量 字体 的 功能 。 

般 情况 下 ，Android 的 各 种 库 是 以 系统 中 间 件 的 形式 提供 的 , 它们 的 显著 特点 是 与 移动 设备 的 


平台 的 应 用 密切 相关 。 另外, Android 的 运行 环境 主要 是 指 Dalvik (虚拟 机 ) R. Dalvik 和 一 般 的 Java 


虚拟 机 
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(Java УМ) 是 有 区 别 的 。 
Java 虚拟 机 : 执行 的 是 Java 标准 的 字 节 码 (Bytecode)。 在 最 新 的 Android 5.0 版 本 中 ， 将 使 
用 ART 为 默认 的 运行 环境 ，Java 虚拟 机 只 是 作为 一 个 备 选 项 而 即将 被 淘汰 。 
Dalvik: 执行 的 是 Dalvik 可 执行 格式 〈.dex) 中 的 执行 文件 。 在 执行 的 过 程 中 ， 每 一 个 应 用 程 
序 即 一 个 进程 (Linux 的 一 个 Process). 


二 者 最 大 的 区 别 在 于 Java 虚拟 机 是 基于 栈 的 虚拟 机 〈Stack-based)， 而 Dalvik 是 基于 寄存 器 的 虚 
拟 机 (Register-based)。 显 然后 者 最 大 的 好 处 在 于 可 以 根据 硬件 实现 更 大 的 优化 ， 这 更 适合 移动 设备 
的 特点 。 
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1.3.3 Application Framework (应 用 程序 框架 ) 


在 整个 Android 系统 中 ， 和 应 用 开发 最 相关 的 是 Application Framework， 在 这 一 层 ，Android 为 应 
用 程序 层 的 开发 者 提供 了 各 种 功能 强大 的 APIs， 这 实际 上 是 一 个 应 用 程序 的 框架 。 由 于 上 层 的 应 用 程 
序 是 以 Java 构建 的 ， 在 本 层 提供 了 程序 中 所 需要 的 各 种 控件 ， 例 如 Views ORHI, List (列表 )、 
Grid CHIPS). Text Box (文本 框 )、Button (按钮 )， 甚 至 还 有 一 个 嵌入 式 的 Web 浏览 器 。 

一 个 基本 的 Andoid 应 用 程序 可 以 利用 应 用 程序 框架 中 的 以 下 5 个 部 分 。 
Activity: 活动 。 
Broadcast Intent Receiver: 广播 意图 接收 者 。 
Service: 服务 。 
Content Provider: 内 容 提 供 者 。 
Intent and Intent Filter: 意图 和 意图 过 滤器 。 


1.3.4 ”顶层 应 用 程序 (Application) 
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Android 的 应 用 程序 主要 是 用 户 界面 (User Interface) 方面 的 ， 本 层 通常 使 用 Java 语言 编写 ， 其 中 
还 可 以 包含 各 种 被 放置 在 res 目录 中 的 资源 文件 。 Java 程序 和 相关 资源 在 经 过 编译 后 , 会 生成 一 个 АРК 
包 。Android 本 身 提供 了 主屏 幕 (Home), RA (Contact), if (Phone) 和 浏览 器 (Browers) 等 
众多 的 核心 应 用 。 同 时 应 用 程序 的 开发 者 还 可 以 使 用 应 用 程序 框架 层 的 API 实现 自己 的 程序 。 这 也 是 
Android 开源 的 巨大 洪 力 的 体现 。 


1.4 核心 组 件 


ERR 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 1 章 \ 核 心 组 件 .avi 

在 分 析 Android 4.4 的 源码 之 前 ， 很 有 必要 了 解 一 下 Android 应 用 程序 的 核心 组 件 功能 。 一 个 典型 
的 Android 应 用 程序 通常 由 5 个 组 件 组 成 , 这 5 个 组 件 构成 了 Android 的 核心 功能 。 本 节 将 详细 讲解 这 
5 大 组 件 的 基本 知识 。 


1.4.1 Activity 界面 


Activities 是 这 5 个 组 件 中 最 常用 的 一 个 组 件 。 程 序 中 Activity 通常 的 表现 形式 是 一 个 单独 的 界面 
(screen)。 每 个 Activity 都 是 一 个 单独 的 类 , 它 扩 展 实现 了 Activity 基础 类 。 这 个 类 显示 为 一 个 由 Views 
组 成 的 用 户 界 面 ,并 响应 事件 。 大 多 数 程序 有 多 个 Activity. 例如 , 一 个 文本 信息 程序 有 这 么 几 个 界面 : 
显示 联系 人 列表 界面 、 写 信息 界面 、 查 看 信息 界面 或 者 设置 界面 等 。 每 个 界面 都 是 一 个 Activity。 切 
换 到 另 一 个 界面 就 是 载 入 一 个 新 的 Activity。 某 些 情 况 下 ， 一 个 Activity 可 能 会 给 前 一 个 Activity 返回 
值 一 一 例如 ， 一 个 让 用 户 选择 相片 的 Activity 会 把 选择 到 的 相片 返回 给 其 调用 者 。 
打开 一 个 新 界面 后 ， 前 一 个 界面 就 被 暂停 ,并 放 入 历史 栈 中 (界面 切换 历史 栈 )。 使 用 者 可 以 回溯 
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前 面 已 经 打开 的 存放 在 历史 栈 中 的 界面 ， 也 可 以 从 历史 栈 中 删除 没有 界面 价值 的 界面 。Android 在 历史 
栈 中 保留 程序 运行 产生 的 所 有 界面 : 从 第 一 个 界面 ， 到 最 后 一 个 。 


1.4.2 Intent 和 Intent Filters 


Android 通过 一 个 专门 的 Intent 类 来 进行 界面 的 切换 。Intent 描述 了 程序 想 做 什么 Intent 意 为 意图 、 目 
的 、 意 向 )。Intent 类 还 有 一 个 相关 类 Intent Filter. Intent 请 求 来 做 什么 事情 ,Intent Filters 则 描述 了 一 个 Activity 
(或 下 文 的 Intent Receiver) 能 处 理 什么 意图 。 显 示 某 人 联系 信息 的 Activity 使 用 了 一 个 Intent Filter， 就 是 
说 它 知 道 如 何 处 理应 用 到 此 人 数据 的 View( 视 图 ) 操 作 。Activities 在 文件 AndroidManifest.xml 中 使 用 Intent 
Filters。 
通过 解析 Intents 可 以 实现 Activity 的 切换 , 我 们 可 以 使 用 startActivity(myIntent) 启 用 新 的 Activity. 
系统 会 考察 所 有 安装 程序 的 Intent Filters， 然 后 找到 与 myIntent 匹配 最 好 的 Intent Filters 所 对 应 的 
Activity。 这 个 新 Activity 能 够 接收 Intent 传 来 的 消息 ， 并 因此 被 启用 。 解 析 Intents 的 过 程 发 生 在 
startActivity 被 实时 调用 时 ， 这 样 做 有 如 下 两 个 好 处 。 
(1) Activities 仅 发 出 一 个 Intent 请 求 ， 便 能 重用 其 他 组 件 的 功能 。 
(2) Activities 可 以 随时 被 蔡 换 为 有 等 价 Intent Filter 的 新 Activity. 


1.4.3 Service 服务 


Service 是 一 个 没有 UI 且 长 驻 系统 的 代码 ， 最 常见 的 例子 是 媒体 播放 器 从 播放 列表 中 播放 歌曲 。 
在 媒体 播放 器 程序 中 ， 可 能 有 一 个 或 多 个 Activities 让 用 户 选 择 播放 的 歌曲 。 然 而 在 后 台 播 放歌 曲 时 无 
Ali Activity 干涉 , 因为 用 户 希望 在 音乐 播放 的 同时 能 够 切换 到 其 他 界面 。 既 然 这 样 , 媒体 播放 器 Activity 
需要 通过 Context.startService() 启 动 一 个 Service， 这 个 Service 在 后 台 运 行 以 保持 继续 播放 音乐 。 在 媒 
体 播放 器 被 关闭 之 前 ， 系 统 会 保持 音乐 后 台 播放 Service 的 正常 运行 。 可 以 用 ContextbindService() 方 法 
连接 到 一 个 Service 上 (如 果 Service 未 运行 的 话 ， 连 接 后 还 会 启动 它 )， 连 接 后 就 可 以 通过 一 个 Service 
提供 的 接口 与 Service 进行 通话 。 对 音乐 Service 来 说 ， 提 供 了 和 暂停 和 重 放 等 功能 。 

1. 如 何 使 用 服务 


在 Android 系统 中 ， 有 如 下 两 种 使 用 Service 服务 的 方法 。 
CD 通过 调用 Context.startService0 启 动 服 务 ， 调 用 Context.stopService()4i RIK, startService() 
可 以 传递 参数 给 Service。 
(2) 通过 调用 ContextbindService0 启 动 ， 调 用 Context.unbindService0 结 束 ， 还 可 以 通过 Service 
Connection 访问 Service。 二 者 可 以 混合 使 用 ， 例 如 可 以 先 startService0 再 unbindService()。 


2. Service 的 生命 周期 


在 使 用 startService() 方 法 启动 服务 后 ， 即 使 调用 startService0 的 进程 结束 了 ，Service 还 仍然 存在 ， 
一 直到 有 进程 调用 stopService0) 或 Service 自己 灭亡 (stopSelfQ) Aik. 

在 bindService()/i, Service 就 和 调用 bindService0 的 进程 同 生 共 死 ， 也 就 是 说 当 调 用 bindService() 
的 进程 死 了 ， 那 么 它 绑 定 的 Service 也 要 跟着 被 结束 ， 当 然 期 间 也 可 以 调用 unbindServiceQit Service 
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结束 。 
当 混 合 使 用 上 述 两 种 方式 时 ， 例 如 你 startService0 〈 启 动 服 务 ) f, j bindServiceO (AE MRF) 
了 ,那么 只 有 你 stopService0 (停止 服务 ) 了 , 而 且 我 也 unbindServiceO (解除 服务 绑 定 ) 了 , 这 个 Service 
才 会 被 结束 。 


з. 进程 生命 周期 


在 Android 系统 中 ， 会 尝试 保留 那些 启动 了 的 或 者 绑 定 了 的 服务 进程 ， 具 体 规则 如 下 所 示 。 

CD 如 果 该 服务 正在 进程 的 onCreate(). onStart)8& 1f onDestroy0 这 些 方法 中 执行 时 ， 那 么 主 进 程 
将 会 成 为 一 个 前 台 进程 ， 以 确保 此 代码 不 会 被 停止 。 

(2) 如 果 服 务 已 经 开始 ， 那 么 它 的 主 进程 的 重要 性 会 低 于 所 有 的 可 见 进程 ， 但 是 会 高 于 不 可 见 进 
程 。 由 于 只 有 少数 几 个 进程 是 用 户 可 见 的 ， 所 以 只 要 不 是 内 存 特 别 低 ， 该 服务 就 不 会 停止 。 

(3) 如 果 有 多 个 客户 端 绑 定 了 服务 ， 只 要 客户 端 中 的 一 个 对 于 用 户 是 可 见 的 ， 就 可 以 认为 该 服务 
可 见 。 


1.4.4 Broadcast Receiver 发 送 广播 


在 Android 系统 中 ，Broadcast Receiver 是 一 个 广播 接收 器 组 件 。 广 播 接收 器 是 一 个 专注 于 接收 广 
播 通知 信息 ， 并 做 出 对 应 处 理 的 组 件 。 很 多 广播 是 源 自 于 系统 代码 的 ， 例 如 ， 通 知 时 区 改变 、 电 池 电 
量 低 、 拍 摄 了 一 张 照片 或 者 用 户 改变 了 语言 选项 。 应 用 程序 也 可 以 进行 广播 一 例如， 通知 其 他 应 用 
程序 一 些 数据 下 载 完成 并 处 于 可 用 状态 。 应 用 程序 可 以 拥有 任意 数量 的 广播 接收 器 以 对 所 有 它 感 兴 
的 通知 信息 予以 响应 ， 所 有 的 接收 器 均 继承 自 BroadcastReceiver 基 类 。 

在 Android 系统 中 , Broadcast Receiver 广播 接收 器 没有 用 户 界面 。 然 而 , 它们 可 以 启动 一 个 Activity 
来 响应 它们 收 到 的 信息 ， 或 者 用 NotificationManager 来 通知 用 户 。 通 知 可 以 用 很 多 种 方式 来 吸引 用 户 
的 注意 力 一 一 闪 动 背 灯 、 振 动 、 播 放声 音 等 。 一 般 来 说 是 在 状态 栏 上 放 一 个 持久 的 图 标 ， 用 户 可 以 打 
开 它 并 获取 消息 。 

Android 中 的 广播 事件 有 两 种 ， 一 种 是 系统 广播 事件 ， 例 如 ACTION BOOT COMPLETED (系统 
启动 完成 后 触发 )、ACTION_TIME_CHANGED (系统 时 间 改 变 时 触发 ) 和 ACTION BATTERY LOW 
(电量 低 时 触发 ) 等 。 另 外 一 种 是 我 们 自 定义 的 广播 事件 。 

在 Android 系统 中 ， 广 播 事件 的 基本 流程 如 下 所 示 。 

(1) 注册 广播 事件 : 注册 方式 有 两 种 ， 一 种 是 静态 注册 ， 即 在 AndroidManifest.xml 文件 中 定义 ， 
注册 的 广播 接收 器 必须 要 继承 Broadcast Receiver; 另 一 种 是 动态 注册 , 是 在 程序 中 使 用 Context Register 
Receiver 注册 ， 注 册 的 广播 接收 器 相当 于 一 个 匿名 类 。 两 种 方式 都 需要 Intent Filter. 

(2) 发 送 广播 事件 : 通过 Context.sendBroadcast KAIF, ЊН Intent 来 传递 注册 时 用 到 的 Action. 

G) 接收 广播 事件 : 当 发 送 的 广播 被 接收 器 监听 到 后 ， 会 调用 它 的 onReceive0 方 法 ， 并 将 包含 消 
息 的 Intent 对 象 传 给 它 。onReceive 中 代码 的 执行 时 间 不 要 超过 55, 1701] Android 会 弹出 超时 对 话 框 。 


1.4.5 用 Content Provider 存储 数据 


在 Android 系统 中 ， 应 用 程序 会 把 数据 存放 在 SQLite 数据 库 格式 文件 中 ， 或 者 存放 在 其 他 有 效 设 
备 中 。 如 果 想 让 其 他 程序 能 够 使 用 我 们 程序 中 的 数据 ， 就 需要 用 到 Content Provider. Content Provider 
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是 一 个 实现 了 一 系列 标准 方法 的 类 ， 这 个 类 使 得 其 他 程序 能 存储 、 读 取 某 种 Content Provider 可 处 理 的 
数据 。 


15 ”进程 和 线程 


ШЫ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 1 章 \ 进 程 和 线程 .avi 

Android 系统 中 也 有 进程 和 线程 ， 代 表 当 前 系统 中 正在 运行 的 程序 。 当 第 一 次 运行 某 个 组 件 时 ， 
Android 会 启动 一 个 进程 。 在 默认 情况 下 ， 所 有 的 组 件 和 程序 运行 在 这 个 进程 和 线程 中 ， 也 可 以 安排 组 
件 在 其 他 的 进程 或 者 线程 中 运行 。 本 节 将 简要 讲解 Android 进程 和 线程 的 基本 知识 。 


15.4 什么 是 进程 


组 件 运行 的 进程 由 manifest file 控制 。 组 件 的 节点 一 般 都 包含 一 个 process 属性 ， 例 如 <activity>、 
<service>、<receiver> 和 <provider> 节 点 。 属 性 process 可 以 设置 组 件 运行 的 进程 ， 可 以 配置 组 件 在 一 个 
独立 进程 中 运行 ， 或 者 多 个 组 件 在 同一 个 进程 中 运行 ， 甚 至 可 以 多 个 程序 在 一 个 进程 中 运行 ， 当 然 前 
提 是 这 些 程序 共享 一 个 User ID 并 给 定 同样 的 权限 。 另 外 <application> 节 点 也 包含 了 process 属性 ， 用 
来 设置 程序 中 所 有 组 件 的 默认 进程 。 

当 更 加 常用 的 进程 无 法 获取 足够 内 存 时 ，Android 会 智能 地 关闭 不 常用 的 进程 。 当 下 次 启动 程序 时 
会 重新 启动 这 些 进程 。 当 决定 哪个 进程 需要 被 关闭 时 ，Android 会 考虑 哪个 对 用 户 更 加 有 用 。 例 如 
Android 会 倾向 于 关闭 一 个 长 期 不 显示 在 界面 的 进程 来 支持 一 个 经 常 显示 在 界面 的 进程 。 是 否 关闭 一 个 
进程 决定 于 组 件 在 进程 中 的 状态 。 


152 ”什么 是 线程 


如 果 用 户 界 面 需要 很 快 对 用 户 进行 响应 ， 就 需要 将 一 些 费时 的 操作 ， 如 网 络 连接 、 下 载 或 者 非常 
占用 服务 器 时 间 的 操作 等 放 到 其 他 线程 。 也 就 是 说 ， 即 使 为 组 件 分 配 了 不 同 的 进程 ， 有 时 也 需要 再 分 
配 线程 。 

线程 是 通过 Java 的 标准 对 象 Thread 来 创建 的 ， 在 Android 中 提供 了 如 下 管理 线程 的 方法 。 

(1) Looper 在 线程 中 运行 一 个 消息 循环 。 

(2) Handler 传递 一 个 消息 。 

(3) HandlerThread 创建 一 个 带 有 消息 循环 的 线程 。 

(4) Android 让 一 个 应 用 程序 在 单独 的 线程 中 ， 指 导 它 创建 自己 的 线程 。 

(5) 应 用 程序 组 件 CActivity. Service. Broadcast Receiver) 都 在 理想 的 主线 程 中 实例 化 。 

(6) 当 被 系统 调用 时 , 没有 一 个 组 件 应 该 执行 长 时 间或 是 阻塞 操作 (例如 网 络 呼叫 或 是 计算 循环 )， 
这 将 中 断 所 有 在 该 进程 的 其 他 组 件 。 

(7) 可 以 创建 一 个 新 的 线程 来 执行 长 期 操作 。 


e. 
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物 联网 是 新 一 代 信息 技术 的 重要 组 成 部 分 ， 其 英文 名 称 是 the Internet of Things. PAA, WH 
网 就 是 物 物 相连 的 互联 网 。 本 节 将 详细 讲解 物 联网 技术 的 基础 知识 。 


16.1 什么 是 物 联网 


物 联网 有 两 层 含义 ， 第 一 ， 物 联网 的 核心 和 基础 仍然 是 互联 网 ， 是 在 互联 网 基础 上 延伸 和 扩展 的 
Wig. 第 二 ， XP HR RT ЕНИ 5 5 物品 之 间 进 行 信息 交换 和 通信 。 物 联网 就 是 “ 物 物 
相连 的 互联 网 ” 物 联 网 通过 智能 感知 、 识 别 技术 与 普 适 计算 ,广泛 应 用 于 网 络 的 融合 中 ， 也 因此 被 称 
为 继 计 算 机 、 互 联网 之 后 世界 信息 产业 发 展 的 第 三 次 浪潮 。 物 联网 是 互联 网 的 应 用 拓展 ， 与 其 说 物 联 
网 是 网 络 ， 不 如 说 物 联网 是 业务 和 应 用 。 因 此 ， 应 用 创新 是 物 联网 发 展 的 核心 ， 以 用 户 体验 为 核心 的 
创新 2.0 是 物 联 网 发 展 的 灵魂 。 

由 此 可 见 ， 物 联网 利用 局 部 网 络 或 互联 网 等 通信 技术 把 传感器 、 控 制 器 、 机 器 、 人 员 和 物 等 通过 
新 的 方式 联系 在 一 起 ， 形 成 人 与 物 、 物 与 物 相 联 ， 实 现 信息 化 、 远 程 管理 控制 和 智能 化 的 网 络 。 物 联 
网 是 互联 网 的 延伸 ， 它 包括 互联 网 及 互联 网 上 所 有 的 资源 ， 兼 容 互联 网 所 有 的 应 用 ， 但 物 联网 中 所 有 
的 元 素 〈《 所 有 的 设备 、 资 源 及 通信 等 ) 都 是 个 性 化 和 私有 化 的 。 


16.2 发展 历程 


物 联网 的 实践 应 用 最 早 可 以 追溯 到 1990 年 施乐 公司 的 网 络 可 乐 贩 售 机 一 一 Networked Coke Machine. 

1991 年 ， 美 国 麻 省 理工 学 院 (MIT) 的 Kevin Ash-ton 教授 首次 提出 物 联网 的 概念 。 

1995 年 ， 比 尔 。 盖 茨 在 《未 来 之 路 》 一 书 中 也 曾 提 及 物 联 网 ， 但 未 引起 广泛 重视 。 

1999 年 ， 美 国 麻 省 理工 学 院 建立 了 “自动 识别 中 心 (Auto-ID)”， 提 出 “万 物 皆 可 通过 网 络 互联 ”， 
阐明 了 物 联 网 的 基本 含义 。 早 期 的 物 联网 是 依托 射频 识别 СВЕТО) 技术 的 物流 网 络 ， 随 着 技术 和 应 用 
的 发 展 ， 物 联网 的 内 涵 已 经 发 生 了 较 大 变化 。 

2003 年 ， 美 国 《技术 评论 》 提 出 传 感 网 络 技术 将 是 未 来 改变 人 们 生活 的 十 大 技术 之 首 。 

2004 年 ， 日 本 总 务 省 (MIC) 提出 u-Japan 计划 ， 该 战略 力求 实现 人 与 人 、 物 与 物 、 人 与 物 之 间 的 
连接 ， 和 希望 将 日 本 建设 成 一 个 随时 、 随 地 、 任 何 物体 、 任 何人 均 可 连接 的 泛 网 络 社会 。 

2005 ££ 11 月 17 日 ， 在 突尼斯 举行 的 信息 社会 世界 峰会 (WSIS) 上 ， 国 际 电信 联盟 (ITU) 发 布 
T d 互联 网 报告 2005: 物 联网 》， 引 用 了 “ 物 联网 ”的 概念 。 物 联网 的 定义 和 范围 已 经 发 生 了 变化 ， 

范围 有 了 较 大 的 拓展 ， 不 再 只 是 指 基 于 RFID 技术 的 物 联网 。 

2006 年 ， 韩 国 确 立 了 u-Korea 计划 ， 该 计划 旨 在 建立 无 所 不 在 的 社会 ubiquitous society)， 在 民 
众 的 生活 环境 里 建设 智能 型 网 络 (如 IPv6、BcN、USN) 和 各 种 新 型 应 用 (如 DMB, Telematics, RFID), 
让 民众 可 以 随时 随地 享有 科技 智慧 服务 。2009 年 ， 韩 国 通信 委员 会 出 台 了 《 物 联网 基础 设施 构建 基本 
规划 》， 将 物 联 网 确定 为 新 增长 动力 ， 提 出 到 2012 年 实现 “通过 构建 世界 最 先进 的 物 联 网 基础 设施 ， 
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打造 未 来 广播 通信 融合 领域 超一流 信息 通信 技术 强国 ”的 目标 。 

2008 年 后 ， 为 了 促进 科技 发 展 ， 寻 找 经 济 新 的 增长 点 ， 各 国政 府 开始 重视 下 一 代 的 技术 规划 ， 将 
目光 放 在 了 物 联网 上 。 

2009 年 ， 欧 盟 执 委 会 发 表 了 欧洲 物 联网 行动 计划 ， 描 绘 了 物 联网 技术 的 应 用 前 景 ， 提 出 欧盟 政府 
要 加 强 对 物 联网 的 管理 ， 促 进 物 联网 的 发 展 。 

2009 年 1 月 28 日 ， 美 国 总 统 与 美国 工商 业 领 袖 举 行 了 一 次 “圆桌 会 议 ” 作为 仅 有 的 两 名 代表 之 
—, IBM 首席 执行 官 彭 明 盛 首次 提出 “智慧 地 球 ” 这 一 概念 ， 建 议 新 政府 投资 新 一 代 的 智慧 型 基础 设 
施 。 当 年 ， 美 国 将 新 能 源 和 物 联 网 列 为 振兴 经 济 的 两 大 重点 。 

2009 年 2 月 24 H, 2009 IBM 论坛 上 ，IBM 大 中 华 区 首席 执行 官 公 布 了 名 为 “智慧 的 地 球 ” 的 最 
新 策略 。 此 概念 一 经 提出 ， 即 得 到 美国 各 界 的 高 度 关 注 ， 甚 至 有 分 析 认 为 IBM 公司 的 这 一 构想 极 有 可 
能 上 升 至 美国 的 国家 战略 ， 并 在 世界 范围 内 引起 又 动 。 

而 今天 ,“ 智 慧 地球 ” 战 略 被 不 少 美国 人 认为 与 当年 的 “信息 高 速 公路 ”有 许多 相似 之 处 ， 同 样 被 
他 们 认为 是 振兴 经 济 、 确 立 竞争 优势 的 关键 战略 。 该 战略 能 否 掀起 如 当年 互联 网 革命 一 样 的 科技 和 经 
济 浪潮 ， 不 仅 为 美国 关注 ， 更 为 世界 所 关注 。 

2009 年 8 月 ， 无 锡 市 率先 建立 了 “感知 中 国 ” 研 究 中 心 ， 中 国 科学 院 、 运 营 商 、 多 所 大 学 在 无 锡 
建立 了 物 联网 研究 院 ， 无 锡 市 江南 大 学 还 建立 了 全 国 首 家 实体 物 联网 工厂 学 院 。 从 此 物 联 网 被 正式 列 
为 国家 五 大 新 兴 战 略 性 产业 之 一 ， 写 入 “政府 工作 报告 ” 物 联网 在 中 国 受到 了 全 社会 极 大 的 关注 ， 其 
受 关注 程度 是 美国 、 欧 盟 以 及 其 他 各 国 不 可 比拟 的 。 

截至 2010 年 ， 发 改 委 、 工 信 部 等 部 委 正在 会 同 有 关 部 门 ， 在 新 一 代 信息 技术 方面 开展 研究 ， 以 形 
成 支持 新 一 代 信息 技术 的 一 些 新 政策 措施 ， 从 而 推动 我 国 经 济 的 发 展 。 

物 联网 作为 一 个 新 经 济 增长 点 的 战略 新 兴 产 业 , 具有 良好 的 市 场 效益 ,《2013 一 2017 年 中 国 物 联网 
行业 应 用 领域 市 场 需求 与 投资 预测 分 析 报 告 》 数 据 表明 ，2010 年 物 联网 在 安防 、 交 通 、 电 力 和 物流 领 
域 的 市 场 规模 分 别 为 600 亿 元 、300 亿 元 、280 亿 元 和 150 亿 元 。2011 年 中 国 物 联网 产业 市 场 规模 达到 
2600 多 亿 元 。 


1.6.3 Android 正在 成 为 物 联 网 标准 操作 系统 


Linux 基金 会 执行 董事 吉姆 。 泽 林 (Jim Zemlin) WN, Android 已 经 在 智能 设备 市 场所 向 披 靡 。 
iOS 只 在 苹果 的 iPhone 和 iPad 上 运行 ， 市 场 深度 不 够 。 相 反 Android 充斥 于 各 种 形状 和 尺寸 及 品牌 的 
硬件 设备 上 .不 同类 型 的 屏幕 、 移 动 芯片 和 传感器 都 可 以 与 Android 完美 配合 , 任何 人 都 可 以 对 Android 
进行 优化 , 使 它 胜任 各 种 工作 .。 泽 林 以 中 国 上 汽 集团 举例 , 上 汽 集团 只 靠 着 6 个 软件 开发 人 员 和 Android 
就 完成 了 内 置 的 车 载 信息 娱乐 系统 。 

美国 宇航 局 艾 姆 斯 研究 中 心 的 年 轻 工 程 师 则 利用 Android 系统 开发 了 宇宙 飞船 的 大 脑 ， 硬 件 大 小 
不 过 一 颗 棒 球 ,卫星 通 常 需要 花费 数 百 万 美元 进行 建造 和 发 射 , 而 这 款 控制 系统 的 造价 不 过 1.5 万 美元 ， 
之 所 以 造价 如 此 低 就 是 因为 采用 了 开源 Android 系统 。 

同样 ，Xively 公司 的 副 总 裁 菲 利 普 也 展示 了 他 最 骄傲 的 物 联 网 作品 : 一 款 基于 Android 的 农业 灌 
溉 系统 。 这 款 系统 利用 一 个 小 型 防水 芯片 建立 调节 水 量 的 网 络 。 菲 利 普 表 示 ,“ 有 了 Android， 你 可 以 
开发 一 些 低 功 耗 的 产品 ， 它 很 容易 进行 用 户 界面 和 触摸 控制 的 开发 ， 同 样 很 容易 处 理 数据 传输 。” 

Android 的 崛起 对 于 微软 来 说 并 不 是 好 事 。 微 软 的 嵌入 式 系统 目前 运行 于 福特 汽车 、NCR 收 款 机 
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等 产品 ， 但 是 微软 的 嵌入 式 系统 并 不 廉价 。 正 像 微软 在 智能 手机 和 平板 电脑 端的 作为 ， 微 软 在 物 联 网 
嵌入 式 操 作 的 表现 并 不 理想 。 菲 利 普 表 示 ， 他 了 解 到 大 量 的 公司 想 要 做 智能 计 步 器 、 网 络 连 接 的 LED 
照明 和 其 他 可 以 与 iPhones 和 iPads 互联 的 设备 。 但 最 后 最 有 可 能 的 就 是 ， 这 些 设备 将 会 选择 Android 
或 更 简单 的 系统 。 至 于 iOS， 蔷 果 似 乎 完全 没有 让 其 运行 在 非 苹果 产品 上 的 想法 。 

安 迪 。 鲁 宾 (Andy Rubin), Kk Android 的 长 期 领导 者 ， 目 前 成 立 了 一 个 位 于 加 利 福 尼 亚 州 洛斯 
阿尔 托 斯 的 孵化 器 ， 在 那里 他 与 朋友 进行 包括 Android 在 内 的 有 趣 开发 项 目 。 鲁 宾 说 ， 谷 歌 已 经 收 到 
了 大 量 的 对 于 Android 进行 物 联 网 化 的 请 求 。 物 联网 还 在 起 步 ， 但 是 似乎 Android 已 经 做 好 了 准备 。 事 
实 终 将 证 明 ，Android 会 在 物 联 网 中 取得 和 在 移动 设备 中 一 样 的 强势 地 位 。 
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因为 Android 系统 的 免费 和 开源 , 也 因为 系统 本 身 强大 的 功能 性 , 使 得 Android 系统 不 仅 被 用 于 手 
机 设备 上 ， 而 且 也 被 广泛 用 于 其 他 智能 设备 中 ， 例 如 当前 的 新 兴 热 点 一 一 可 穿戴 设备 。 本 节 将 简要 介 
绍 除了 手机 产品 之 外 ， 常 见 的 搭载 Android 系统 的 智能 设备 。 


1.7.1 ”常见 的 Android 智能 设备 


OD 智能 电视 

Android 智能 电视 是 指 搭 载 了 安 卓 操作 系统 的 电视 ， 使 得 电视 智能 化 ， 能 让 电视 机 实现 网 页 浏览 、 
视频 电影 观看 、 聊 天 办 公 游 戏 等 与 平板 电脑 和 智能 手机 一 样 的 功能 。 其 凭借 安 卓 系统 让 电视 实现 智能 
化 的 提升 ， 数 十 万 款 安 卓 市 场 的 应 用 、 游 戏 等 内 容 可 随意 安装 。 例 如 海尔 的 MOOKA 模 卡 U42H7030 
便 是 一 款 搭载 Android 4.2 系统 的 智能 电视 ， 如 图 1-3 所 示 。 
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1-3 153 Android 4.2 系统 的 智能 电视 


(2) 机 顶 盒 

Android 机 项 盒 是 指 像 智 能 手机 一 样 ， 具 有 全 开放 式 平 台 ， 搭 载 了 安 卓 操作 系统 ， 可 以 由 用 户 自 行 
安装 和 种 载 软件 、 游 戏 等 第 三 方 服务 商 提供 的 程序 ， 通 过 此 类 程序 来 不 断 对 电视 的 功能 进行 扩充 ， 并 
可 以 通过 网 线 、 无 线 网 络 来 实现 上 网 冲浪 的 新 一 代 机 项 盒 的 总 称 。 

通过 使 用 Android 机 顶 盒 ， 可 以 让 电视 具有 上 网 、 看 网 络 视频 、 玩 游戏 、 看 电子 书 、 听 音乐 等 功 
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能 ， 使 电视 成 为 一 个 低 成 本 的 平板 电脑 ，Android 机 顶 盒 不 仅仅 是 一 个 高 清 播 放 器 ， 更 具有 一 种 全 新 的 
人 机 交互 模式 ， 既 区 别 于 电脑 ， 又 有 别 于 触摸 屏 ，Android 机 项 盒 配备 红外 感应 条 ， 遥 控 器 一 般 采 用 空 
中 飞 鼠 ， 这 样 就 可 以 方便 地 实现 触摸 屏 上 的 各 种 单 点 操作 ， 可 以 方便 地 在 电视 上 玩 愤怒 的 小 鸟 、 植 物 
大 战 僵尸 等 经 典 游戏 。 例 如 乐 视 公 司 的 LeTV 机 项 盒 便 是 基于 Android 打造 的 ， 如 图 1-4 所 示 。 

(з) 游戏 机 

Android 游戏 机 就 像 Android 智能 手表 一 样 ,在 2013 年 出 现 了 爆炸 式 增长 .在 CES 展会 上 ，NVIDIA 
的 Project Shield 掌上 游戏 主机 以 绝对 震撼 的 姿态 亮相 ， 之 后 又 有 Ouya 和 Gamestick 相继 推出 。 不 久 
ЇЙ, Mad Catz 也 发 布 了 一 款 Andriod 游戏 机 。 

(4) 智能 手表 

智能 手表 ， 是 将 手表 内 置 智能 化 系统 、 搭 载 智能 手机 系统 而 连接 于 网 络 而 实现 多 功能 ， 能 同步 手 
机 中 的 电话 、 短 信 、 邮 件 、 照 片 、 音 乐 等 。2013 年 3 月 媒体 报道 ， 苹 果 、 三 星 、 谷 歌 等 科技 巨头 都 将 
在 2013 年 晚 些 时 候 发 布 智能 手表 。 美 国 市 场 研究 公司 Current Analysis 分 析 师 艾 维 。 格 林 加 特 〈Avi 
Greengart) 认为 2013 年 可 能 会 成 为 智能 手表 元 年 。 例 如 三 星 的 Galaxy Gear 便 是 一 款 搭载 Android 系 
统 的 智能 手表 设备 ， 如 图 1-5 所 示 。 


图 1-4 基于 Android 的 LeTV 机 项 盒 图 1-5 搭载 Android 系统 的 Galaxy Gear 

(5) 智能 家 居 

智能 家 居 是 以 住宅 为 平台 ， 利 用 综合 布线 技术 、 网 络 通信 技术 、 智 能 家 居 - 系 统 设计 方案 安全 防范 
技术 、 自 动 控制 技术 、 音 视频 技术 将 家 居 生 活 有 关 的 设施 集成 ， 构 建 高 效 的 住宅 设施 与 家 庭 日 程 事务 
的 管理 系统 ， 提 升 家 居 安 全 性 、 便 利 性 、 和 舒适 性 、 艺 术 性 ， 并 实现 环保 节能 的 居住 环境 。 

智能 家 居 是 在 互联 网 的 影响 之 下 的 物 联 化 体现 。 智 能 家 居 通 过 物 联 网 技术 将 家 中 的 各 种 设备 〈 如 
音 视频 设备 、 照 明 系 统 、 窗 帘 控 制 、 空 调控 制 、 安 防 系统 、 数 字 影 院 系统 、 网 络 家 电 以 及 三 表 抄 送 等 ) 
连接 到 一 起 ， 提 供 家电 控 制 、 照 明 控制 、 窗 帘 控 制 、 电 话 远程 控制 、 室 内 外 遥控 、 防 盗 报 警 、 环 境 监 
测 、 暖 通 控制 、 红 外 转发 以 及 可 编程 定时 控制 等 多 种 功能 和 手段 。 与 普通 家 居 相 比 ， 智 能 家 居 不 仅 具 
有 传统 的 居住 功能 ， 还 兼备 建筑 、 网 络 通信 、 信 息 家 电 、 设 
备 自动 化 ， 是 集 系 统 、 结 构 、 服 务 、 管 理 为 一 体 的 高 效 、 舒 
适 、 安 全 、 便 利 、 环 保 的 居住 环境 ， 可 以 提供 全 方位 的 信息 
交互 功能 ， 帮 助 家 庭 与 外 部 保持 信息 交流 畅通 ， 优 化 人 们 的 
生活 方式 , 帮助 人 们 有 效 安排 时 间 , 增强 家 居 生 活 的 安全 性 ， 
甚至 为 各 种 能 源 费用 节约 资金 。 

例如 乐得 威 公 司 的 GW-9311 智能 主机 产品 便 是 一 款 
Android 智能 家 居 产 品 ， 如 图 1-6 所 示 。 

上 述 智能 设备 只 是 冰山 一 角 ， 随 着 物 联网 和 云 服 务 的 普 图 1-6 乐得 威 公司 的 GW-9311 智能 主机 
及 和 发 展 ， 将 有 更 多 的 智能 设备 诞生 。 到 那个 时 候 ，Android 
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系统 更 是 如 鱼 得 水 ， 将 拥有 一 个 更 美好 的 未 来 。 
1.7.2 ”新 兴 热 点 一 一 可 穿戴 设备 


在 最 近 两 年 来 ， 随 着 Android 和 iOS 系统 的 发 展 ， 可 穿戴 设备 逐渐 展现 在 广大 用 户 的 面前 。 谷 歌 
眼镜 、 苹 果 手 表 等 新 颖 而 又 时 尚 的 设备 吸引 了 广大 用 户 的 眼球 ， 相 信 在 未 来 这 些 设备 必 将 引领 时 尚 的 
潮流 ， 成 为 科技 界 的 主流 产品 之 一 。 自 从 谷歌 推出 Google 眼镜 产品 之 后 ， 可 穿戴 计算 设备 便 成 为 了 当 
今 科技 界 的 火热 话题 之 一 。 在 CES 2013 和 CES 2014 (国际 电子 展 ) 上 ， 也 有 不 少 公司 推出 了 了 眼镜、 
腕 带 等 各 种 可 穿戴 计算 设备 ， 可 穿戴 计算 也 越 来 越 火热 。 


1. 发 展 背景 


穿戴 设备 看 似 是 一 个 新 兴 事 物 , 但 实际 上 其 发 展 历史 可 以 上 淹 到 20 世纪 80 年 代 。 多 伦 多 大 学 Steve 
Mann 教授 被 人 称 为 “可 穿戴 计算 之 父 ”， 公 认 的 第 一 个 赛 博 格 (Cyborg) 一 一 这 是 一 个 特殊 的 群体 ， 
他 们 很 像 科幻 小 说 中 的 一 些 角色 ， 利 用 机 器 设备 来 增强 自己 的 感觉 ， 从 而 加 强 对 环境 的 掌控 。 

Steve Mann 自 20 世纪 80 年 代 就 开始 尝试 制作 类 似 于 Google Glass 这 样 可 以 架 在 自己 的 鼻梁 上 ， 
以 第 一 人 称 的 角度 来 记录 周遭 事物 的 眼镜 。Mann 最 初 设计 的 设备 是 戴 在 头盔 上 的 ， 而 经 过 多 年 的 实 
验 和 反复 改进 ， 他 的 头 戴 式 智 能 眼镜 变 得 越 来 越 轻巧 。 后 来 Mann 成 功 开发 出 令 智能 眼镜 小 型 化 ， 并 
与 电脑 和 网 络 相连 的 技术 EyeTab， 这 比 Google 眼镜 要 早 13 年 。 

以 Google 眼镜 为 代表 的 这 种 穿戴 设备 ， 和 智能 手机 最 大 的 不 同 是 把 用 户 的 眼睛 和 手 从 设备 上 解放 
出 来 了 ， 所 以 不 需要 从 忽 里 掏 出 一 个 东西 ， 也 不 需要 低下 头 去 看 它 ， 它 永远 在 你 前 面 。 所 以 我 们 有 理 
由 相信 ， 可 穿戴 计算 设备 (不 一 定 是 Google 眼镜 ) 一 定 可 以 给 人 们 带 来 更 大 的 自由 ， 并 且 在 将 来 一 定 
会 成 为 潮流 趋势 。 


2. 发 展现 状 介绍 


可 穿戴 计算 设备 将 成 为 继 智 能 手机 、 平 板 电脑 之 后 的 又 一 个 潮流 。 当 前 可 穿戴 技术 正在 处 于 一 种 
过 渡 时 期 ， 一 些 看 似 疯狂 的 想法 逐渐 在 摸索 中 变 得 更 加 成 熟 。 在 CES 2014 电子 消费 展 上 , 我 们 已 经 看 
到 类 似 Pebble Steel 这 样 拥有 更 精致 设计 的 智能 手表 ， 还 有 很 多 其 他 运动 腕 带 、 智 能 眼镜 等 产品 参与 展 
出 ， 下 面 一 起 来 回顾 一 下 这 些 出 色 的 可 穿戴 设备 。 

(1) Google Project Glass 

谷歌 眼镜 (Google Project Glass) 是 由 谷歌 公司 于 2012 年 4 月 发 布 的 一 款 “ 拓 展现 实 ” 眼 镜 ， 如 
图 1-7 所 示 。 谷 歌 眼镜 具有 和 智能 手机 一 样 的 功能 ， 可 
以 通过 声音 控制 拍照 、 视 频 通话 和 辨 明 方向 以 及 上 网 冲 
浪 、 处 理 文字 信息 和 电子 邮件 等 。 

2013 年 4 月 10 日 ， 美 国 科技 博客 Gizmodo 发 布 了 
一 张 图 片 ， 揭 示 了 谷歌 智能 眼镜 的 工作 原理 。 谷 歌 眼镜 
承载 着 可 穿戴 设备 的 开端 ， 它 极 具 想 象 空间 ， 前 途 不 可 
限量 。 但 现在 看 来 ， 它 暂时 只 是 一 个 手机 伴侣 。 基 础 通 
信 、 文 字 输 入 还 依赖 手机 。 1л 谷歌 眼镜 

2013 年 11 月 12 日 ,发 布谷 歌 眼 镜 的 一 系列 新 功能 ， 
包括 搜索 歌曲 、 扫 描 已 保存 播放 列表 ,以 及 收听 高 保 真 音 乐 等 。 美国 东部 时 间 2014 年 4 月 15 日 早上 9 
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Fi, Google Glass 正式 开放 网 上 订购 。 
(2) 苹果 智能 手表 
苹果 智能 手表 ， 是 苹果 正在 秘密 研发 的 智能 手表 产品 。 苹 果 手 表 可 能 将 采用 1.5 至 2 英寸 显示 屏 ， 
并 将 采用 指纹 识别 技术 。 苹 果 成 立 了 一 支 100 人 左右 的 开发 团队 ， 专 门 开 发 这 款 设备 。2013 年 5 月 ， 
凯 基 证 券 分 析 师 郭 明 池 (Ming-ChiKuo) 在 一 份 报告 中 指出 ， 苹 果 手 表 的 零 部 件 尚未 成 熟 ， 苹 果 手 表 最 
早 2014 年 下 半年 投产 。 而 人 苹果 CEO 带 姆 - 库 克 (TimCook) 曾 表示 ， 苹 果 期 待 2013 年 秋季 和 整个 2014 
年 将 推出 令 人 兴奋 的 新 产品 。 苹 果 手 表 的 预期 效果 如 图 1-8 所 示 。 
(3) MetaWatch 

MetaWatch 是 一 款 智能 手表 ， 其 设计 师 此 前 设计 了 奢侈 品 手机 Vertu， 所 以 非常 擅长 将 时 尚 元 素 与 

电子 产品 有 机 结合 ， 如 图 1-9 所 示 。 


图 1-8 苹果 手表 1-9 MetaWatch 


由 此 可 以 看 到 ，MetaWatch 的 金属 表盘 充满 质感 ， 皮 革 腕 带 也 显得 十 分 高 级 ， 无 论 是 搭配 西装 还 
是 T 恤 ， 都 十 分 合适 。MetaWatch 支持 10 至 15 米 防水 ,支持 ios 设备 ， 用 户 可 以 从 App Store 中 下 载 
应 用 程序 ， 实 现 更 多 信息 的 通知 功能 。 

(4) Garmin Vivofit 

健身 腕 带 Garmin Vivofit 一 一 知名 GPS 厂商 Garmin 此 前 推出 过 运动 手表 产品 ， 此 次 更 是 推出 了 
Vivofit 健身 腕 带 ， 全 面 进入 到 运动 监测 设备 市 场 。 这 款 运 动 腕 带 的 设计 充满 活力 ， 拥 有 多 种 配色 款式 ， 
不 仅 能 够 实现 全 面 的 运动 数据 监测 ， 还 支持 心率 监测 ， 与 手机 端的 应 用 搭配 ， 可 实现 出 色 的 健身 运动 
监测 功能 ， 如 图 1-10 所 示 。 

(5) 英特尔 智能 手表 及 手镯 

芯片 巨头 英特尔 在 CES 2014 上 也 宣布 进入 可 穿戴 设备 领域 ， 将 陆续 推出 智能 手表 、 手 镯 等 产品 。 
有 意思 的 是 ， 英 特 尔 的 智能 手镯 将 与 时 尚 百货 Barneys 合作 推出 ， 或 许 能 够 让 可 穿戴 设备 在 时 尚 领域 
更 进一步 ， 如 图 1-11 所 示 。 


1-11 英特尔 智能 手表 及 手镯 
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可 穿戴 设备 是 延续 性 地 穿戴 在 人 体 上 ， 具 备 先进 的 电路 系统 、 无 线 联网 及 独立 处 理 能 力 的 终端 设 
备 ， 其 具备 最 重要 的 两 个 特点 是 可 长 期 穿戴 和 智能 化 。 在 智能 手机 和 平板 的 发 展 进入 停滞 期 后 ， 以 智 
能 眼镜 、 手 表 等 为 代表 的 智能 可 穿戴 设备 成 为 谷歌 、 苹 果 等 巨头 下 一 部 竞争 的 主 战场 。 著 名 科技 媒体 
Android Authority 的 扎 稿 人 奈 特 。 斯 旺 纳 (Nate Swanner) 曾经 撰文 对 2014 年 进行 了 展望 ， 他 总 结 道 : 
穿戴 设备 将 会 蓬勃 发 展 。 消 费 者 有 望 买 到 谷歌 眼镜 ， 而 且 市 场 上 会 出 现 很 多 智能 手表 。 如 果 你 有 意 购 
买 一 款 这 样 的 设备 ， 请 务必 保持 谨慎 乐观 的 心态 。 毕 竞 ， 你 在 这 类 产品 爆炸 式 发 展 初期 买 下 的 设备 ， 
确实 有 可 能 在 未 来 几 年 里 登 L “有史 以 来 最 糟糕 产品 ”的 榜 单 。 

(1) 智能 手机 推动 力 

智能 手机 是 可 穿戴 设备 爆发 的 核心 驱动 力 之 一 ， 智 能 手机 现在 已 经 不 只 是 拿 来 打 电话 ， 或 者 是 上 
网 ， 其 内 建 的 处 理 器 与 操作 系统 具有 强大 的 运算 能 力 ， 使 它 成 为 远程 的 计算 机 引擎 ， 而 同时 智能 手机 
具有 广泛 的 用 户 基础 ， 预 计 未 来 ， 手 机 可 能 作为 智能 控制 中 心 和 计算 系统 ， 使 可 穿戴 设备 、 平 板 、 笔 
记 本 、 电 视 等 所 有 终端 保持 互联 ， 而 每 个 人 的 身体 及 可 穿戴 设备 将 变 成 微 网 络 ， 身 上 配 戴 的 各 式 与 智 
能 手机 联接 的 装饰 ， 提 供 各 类 功能 并 与 智能 手机 、 云 端 进行 数据 计算 和 交互 。 根 据 权 威 统计 数据 证 明 ， 
中 国 移动 互联 网 用 户 已 超过 桌面 互联 网 用 户 。 

(2) 跨国 公司 推动 力 

随 着 智能 手机 渗透 率 快 速 提升 ， 便 携 性 要 求 出 现 、 硬 件 配置 提升 、 传 感 器 及 电池 改善 ， 可 穿戴 设 
备 的 便携 、 云 端 互 联 等 性 能 优势 将 越 来 越 明 显 ， 预 计 可 穿戴 设备 将 继 智能 手机 之 后 成 为 下 一 个 爆发 性 
增长 点 。 尤 其 是 苹果 、 人 谷歌、 微软 、 亚 马 逊 和 Facebook 5 大 平台 及 相应 开发 者 都 进入 可 穿戴 设备 领域 
时 ， 后 台数 据 及 前 端 检测 传输 更 加 完善 时 ， 可 穿戴 设备 将 会 变 成 主流 。 按 照 ShareThis 2013 年 6 月 最 
新 数据 ， 消 费 者 在 移动 设备 上 点 击 和 分 享 内 容 的 行为 是 桌面 电脑 的 2 倍 ， 随 着 社交 网 络 越发 重要 ， 可 
供 分 享 的 数据 暴 增 。 以 社交 分 享 平台 中 份额 最 高 的 Facebook 和 Google 来 研究 ， 按 照 Searchmetrics 数 
据 ， 目 前 Facebook 的 分 享 量 以 每 个 月 10% 的 速度 增长 ，Google 分 享 量 目前 以 每 月 19% 的 速度 增长 ， 截 
至 2013 年 4 J] , Facebook 和 Google 的 数据 分 享 量 相 比 2012 年 初 增长 分 别 是 202% 及 788%, 数据 分 享 
爆发 时 代 到 来 。 即 时 的 数据 分 享 和 社交 网 络 的 需求 将 导致 用 户 对 各 类 移动 终端 需求 不 断 提升 ， 可 穿戴 
设备 在 数据 分 享 和 社交 领域 具备 放量 基础 。 

(3) 用 户 推动 力 

用 户 对 健身 、 医 疗 及 健康 监测 等 需求 也 在 持续 抬升 ， 未 来 可 穿戴 设备 作为 新 一 代 智能 终端 ， 将 成 
为 新 的 移动 平台 市 场 及 生态 圈 ， 硬 件 终端 不 仅 是 营 收 增长 点 ， 也 将 成 为 黏 住 客户 的 产品 形态 ， 进 而 转 
绕 消费 者 形成 可 穿戴 设备 、 手 机 、 平 板 、 笔 记 本 、 电 视 、 汽 车 等 终端 互联 互通 的 一 体 化 智能 方案 ， 因 
此 原 软 硬 件 、 互 联网 等 各 类 厂商 均 参与 到 推出 硬件 终端 产品 的 环节 中 来 。 

在 可 穿戴 设备 领域 应 用 中 ， 目 前 较 受 欢迎 的 应 用 是 娱乐 和 社交 ， 而 较 快 进入 商用 的 功能 是 健身 、 
医疗 及 健康 监测 。 娱 乐 和 社交 领域 的 典型 产品 包括 Google/ 百 度 智能 眼镜 、Sony/ 三 星 / 果 过 智能 手表 等 ， 
医疗 和 健康 领域 ， 可 穿戴 式 设 备 主要 包括 脉搏 血 氧 仪 、 葡 萄 糖 监测 、 心 电 图 (ECG)、 助 听 器 、 药 物 输 
送 等 类 型 产品 ， 目 前 主要 功能 进行 一 体 化 整合 成 为 趋势 ， 如 三 星 智能 手表 同时 也 具备 健康 监测 功能 。 

据 数据 显示 ，2012 年 中 国 可 穿戴 便携 移动 医疗 设备 市 场 销售 规模 达到 4.2 亿 元， 预计 到 2015 年 这 
一 市 场 规模 将 超过 10 亿 元 ， 到 2017 年 中 国 可 穿戴 便携 移动 医疗 设备 市 场 销售 规模 将 接近 50 亿 元 , 市 


© 


物 联网 开发 从 入 门 到 实战 


场 年 复合 增长 达到 60%。 

HIS 预计 全 球 范围 内 与 健康 相关 的 可 穿戴 设备 App 应 用 装机 量 (或 下 载 量 ) 会 从 2012 年 的 1.56 
ILERE 2017 年 的 2.48 亿 ， 随 着 开发 者 加 入 及 生态 环境 改善 ， 可 穿戴 设备 将 放量 增长 。 

第 三 方 机 构 EndpointTechnologiesAssociates 预计 ， 若 未 来 5 年 可 穿戴 设备 市 场 占 比 达 4000 万 个 ， 
便 可 能 为 开发 商 带 来 4 亿美 元 的 商机 ， 而 程序 内 广告 (in-APPadvertising) 可 能 大 幅 提 升 营 收 。 


1.7.4 Android 对 穿戴 设备 的 支持 一 一 Android Wear 


自从 Bluetooth Smart 低 耗 能 技术 推出 后 ， 穿 戴 设 备 的 开发 创造 了 良好 的 条 件 。 苹 果 是 从 1055 
GPhone 4S 以 及 以 上 版 本 的 手机 ) 开始 支持 Bluetooth Smart, Mi Google 直到 Android 4.3 才 开 始 支持 。 
Google 在 Android 4.3 中 添加 了 Bluetooth Smart， 在 操作 系统 层面 建立 一 个 统一 标准 。 也 就 是 说 ， 从 
Android 4.3 开始 , 将 完全 支持 新 蓝牙 传输 技术 , 这 样 就 为 可 穿戴 设备 开发 铺 平 了 道路 。 而 在 Android 4.4 
中 ， 新 增加 了 地 磁 旋 转 矢 量 、 脚 步 探 测 器 和 计 步 器 3 个 传感器 类 别 ， 这 些 功 能 很 可 能 是 面向 谣传 的 谷 
歌 Android 智能 手表 、 谷 歌 眼 镜 以 及 非 谷歌 出 厂 的 设备 。 随 着 更 多 的 厂商 在 产品 中 加 入 运动 传感器 ， 
追踪 人 们 运动 的 Android 手机 应 用 也 将 从 该 新 功能 中 获 益 。 

北京 时 间 2014 年 3 月 19 日 ， 谷 歌 正式 公布 了 可 穿戴 设备 操作 系统 Android Wear. Android Wear 
是 Android 的 一 个 修改 版 ， 基 于 Google Now 语音 识别 技术 ， 针 对 可 穿戴 计算 设备 设计 ， 最 初 将 被 用 在 
智能 手表 中 。 谷 歌 同 时 表示 ，LG、 华 硕 、HTC、 摩 托 罗 拉 移 动 和 三 星 将 是 Android Wear 的 硬件 合作 伙 
伴 ， 而 博通 、Imagination、 英 特 尔 、 联 发 科 和 高 通 将 是 芯片 合作 伙伴 。Fossil Group 将 于 2014 年 晚 些 
时 候 推出 采用 Android Wear 的 智能 手表 。LG 和 谷歌 将 在 谷歌 IO 开发 者 大 会 上 发 布 智能 手表 ， 而 LG 
将 是 推出 谷歌 智能 手表 的 首 家 合作 伙伴 。 

Android Wear 与 谷歌 眼镜 类 似 ， 将 基于 Google Now 和 语音 命令 。 通 过 OK Google 的 语音 指令 , 用 
户 可 以 提问 或 发 送 文 字 消息 。 谷 歌 表 示 ，Android Wear 的 设计 是 为 了 提供 相关 性 更 好 的 信息 ， 以 及 来 
自 社交 媒体 应 用 的 通知 、 消 息 应 用 的 提示 ， 以 及 购物 、 新 闻 和 拍照 应 用 的 通知 等 。 这 一 修改 版 Android 
系统 将 专注 于 健康 和 运动 追踪 功能 。FitBit Force 和 耐克 FuelBand 等 产品 推动 了 这 类 功能 的 发 展 。 谷 歌 
还 希望 ，Android Wear 将 成 为 联系 用 户 与 其 他 设备 ， 包 括 电视 机 和 计算 机 的 纽带 。 业 内 人 士 希望 ， 谷 
歌 的 进入 将 有 助 于 提升 智能 手表 的 设计 美学 。 尽 管 可 穿戴 计算 设备 目前 非常 热门 ， 但 相关 产品 的 销售 
情况 并 不 火爆 。 三 星 第 一 代 Galaxy Gear 和 索尼 SmartWatch 仍 是 小 众 产 品 ， 这 两 款 产 品 的 尺寸 过 大 ， 
并 不 时 尚 。 对 可 穿戴 计算 设备 的 其 他 不 满 还 包括 电池 续航 时 间 过 短 ， 以 及 缺少 某 些 实用 功能 等 。 
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Android 作为 一 项 新 兴 技 术 ， 在 进行 开发 前 首先 要 搭建 一 个 对 应 的 开发 环境 。Android 开发 包括 底 
层 开发 和 应 用 开发 ， 底 层 开发 大 多 数 是 指 和 硬件 相关 的 开发 ， 并 且 是 基于 Linux 环境 的 ， 例 如 开发 驱 
动 程序 。 应 用 开发 是 指 开发 能 在 Android 系统 上 运行 的 程序 ， 例 如 游戏 、 地 图 等 。 本 书 的 重点 是 物 联 
网 开发 技术 ， 这 要 求 开 发 人 员 既 需要 掌握 底层 开发 的 知识 ， 也 需要 上 层 应 用 开发 的 知识 。 所 以 本 章 将 
详细 讲解 搭建 Android 底层 和 应 用 开发 环境 的 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打下 基础 。 


2. 在 Linux 系统 获取 Android 源码 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 2 章 \ 在 Linux 系统 获取 Android 源码 .avi 
在 Linux 系统 中 ， 通 常 使 用 Ubuntu 来 下 载 和 编译 Android 源码 。 由 于 Android 的 源码 内 容 很 多 ， 
Google 采用 了 git 的 版 本 控制 工具 ， 并 对 不 同 的 模块 设置 不 同 的 git 服务 器 , 我 们 可 以 用 repo 自动 化 脚 
本 来 下 载 Android 源码 ， 下 面 介绍 如 何 一 步 一 步 地 获取 Android 源码 的 过 程 。 
(1) T repo 
在 用 户 目录 下 ， 创 建 bin 文件 夹 ， 用 于 存放 repo， 并 把 该 路 径 设置 到 环境 变量 中 去 ， 命 令 如 下 : 
$ mkdir ~/bin 
$ PATH=~/bin:$PATH 
下 载 repo 的 脚本 ， 用 于 执行 repo， 命 令 如 下 : 
$ curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > ~/bin/repo 
设置 可 执行 权限 ， 命 令 如 下 : 
$ chmod a+x ~/bin/repo 
(2) 初始 化 一 个 repo 的 客户 端 
在 用 户 目录 下 ， 创 建 一 个 空 目录 ， 用 于 存放 Android 源码 ， 命 令 如 下 : 
$ mkdir AndroidCode 
$ cd AndroidCode 


进入 到 AndroidCode 目录 ， 并 运行 repo 下 载 源码 ， 下 载 主线 分 支 的 代码 ， 主 线 分 支 包 括 最 新 修改 
的 bug， 以 及 并 未 正式 发 出 版 本 的 最 新 源码 ， 命 令 如 下 : 
$ repo init -u https://android.googlesource.com/platform/manifest 


下 载 其 他 分 支 ， 正 式 发 布 的 版 本 ， 可 以 通过 添加 -b 参数 来 下 载 ， 命 令 如 下 : 
$ repo init -u https://android.googlesource.com/platform/manifest -b 
android-4.4 r1 


在 下 载 过 程 中 会 需要 填写 Маше 和 Email， 填 写 完毕 之 后 ， 选 择 Y 进行 确认 ， 最 后 提示 repo 初始 
化 完成 ， 这 时 可 以 开始 同步 Android 源码 了 ， 同 步 过 程 很 漫长 ， 需 要 耐心 等 待 ， 执 行 下 面 命令 开始 同 
步 代 码 : 

$ repo sync 
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经 过 上 述 步骤 后 ， 便 开始 下 载 并 同步 Android 源码 ， 界 面 效 果 如 图 2-1 所 示 。 


图 2-1 下 载 同 步 


22 在 Windows 平台 获取 Android 源码 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 2 章 \ 在 Windows 平台 获取 Android 源码 .avi 
在 Windows 平台 获取 Android 源码 的 原理 和 Linux 相同 ， 但 是 需要 预先 在 Windows 平台 上 面 搭建 
-个 Linux 模拟 环境 ， 笔 者 使 用 的 是 cygwin TA. cygwin 的 作用 是 构建 一 套 在 Windows 上 的 Linux 
模拟 环境 ， 下 载 cygwin 工具 的 地 址 为 http;/cygwin.com/install.html. 
下 载 成 功 后 会 得 到 一 个 名 为 setup.exe 的 可 执行 文件 , 通过 此 文件 可 以 更 新 和 下 载 最 新 的 工具 版 本 ， 
具体 流程 如 下 : 
(1) 启动 cygwin， 如 图 2-2 所 示 。 
(2) 单 击 “ 下 一 步 ” 按 钮 ， 选 中 第 一 个 单 选 按钮 : 从 网 络 下 载 安装 ， 如 图 2-3 所 示 。 
[> суі 1ш > Cygvin Setup - Choose Installation Type lolx 


<. Cygwin Net Release Setup Program 


Please note that Cygwin consists cf a large number of 


= Thi setup program is used for the intial installation ofthe 
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packages spanning a wide variety of purposes. We only rm рын аа погане тіне 

E) install a base set of packages by defaut. You can always un 
this program а any time in the future to add, remove. or © Download Without nstaling 
upgrade packages as necessary 


C. tal from Local rectory 
Setup.exe version 2.819 (32 bit) 


Copyright 2000-2013 
_аж | —m»* | 
图 2-2 ”启动 cygwin 图 2-3 选择 从 网 络 下 载 安装 
(3) 单 击 “ 下 一 步 ” 按 钮 ， 选 择 安装 根 目录 ， 如 图 2-4 所 示 。 


(D 单 击 “ 下 一 步 ” 按 钮 ， 选 择 临时 文件 目录 ， 如 图 2-5 所 示 。 


e. 


= Cygwin Setup ~ Choose Installation Direc 


‘Select Root Install Directory 
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图 2-4 选择 安装 根 目录 
(5) "fl; “Fb” 按钮， 设置 网 络 代理 。 
不 用 代理 ， 则 选择 直接 下 载 ， 如 图 2-6 所 示 。 
(6) 单 击 “ 下 一 步 ” 按 钮 ， 选 择 下 载 站 点 。 
选择 的 是 台湾 站 点 ， 如 图 2-7 所 示 。 


Cygwin Setup ~ Select Connection Type 


‘Select Your Intemet Connection. 
Setup needs to know how you want t to connect to the intomet, Choose 
the apprcprate settings below. 
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图 2-5 选择 临时 文件 目录 
如 果 所 在 网 络 需要 代理 ， 则 在 这 一 步 进 行 设置 ， 如 果 


一 般 选择 离 我 们 比较 近 的 站 点 ， 速 度 会 比较 快 ， 这 里 
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图 2-6 设置 网 络 代理 
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图 2-7 选择 下 载 站 点 


CD 单 击 “ 下 一 步 ”按钮 ， 开 始 更 新 工具 列表 ， 如 图 2-8 所 示 。 
(8) 单 击 “ 下 一 步 ”按钮 ， 选 择 需 要 下 载 的 工具 包 。 在 此 需要 依次 下 载 curl. git. python 这 些 工 


具 ， 如 图 2-9 所 示 。 
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2-8 更 新 工具 列表 
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2-9 依次 下 载 工具 


Android 物 联网 开发 从 入 门 到 实战 


为 了 确保 能 够 安装 上 述 工具 ， 一 定 要 用 鼠标 双击 变 为 Install 形式 ， 如 图 2-10 所 示 。 
i“ 下 一 步 ” 按 钮 ， 系 统 显示 下 载 进 度 条 ， 如 图 2-11 所 示 。 
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图 2-10 务必 设置 为 Install 形式 图 2-11 下 载 进度 条 


如 果 下 载 安装 成 功 会 出 现 提示 信息 ， 单 击 “ 完 成 ”按钮 即 完成 安装 。 当 安装 好 суруш 后 ， 打 开 
cygwin, 会 模拟 出 一 个 Linux 的 工作 环境 , 然后 按照 Linux 平台 的 源码 下 载 方法 即 可 下 载 Android 源码 。 

建议 读者 在 下 载 Android 源码 时 ,严格 按 方 提供 的 步骤 进行 ,地 址 是 http://source.android.com/ 
source/downloading.html， 这 一 点 对 初学 :者 来 说 尤为 重要 。 另 外 ， 整 个 下 载 过 程 比较 漫长 ， 需 要 大 家 耐 
心 等 待 。 如 图 2-12 所 示 是 笔者 下 载 Android 4.4 时 的 机 器 命令 截图 。 


por 


图 2-12 在 Windows 中 用 cygwin LA FR Android 源码 的 截图 


23 编译 源码 


ERU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 2 章 \ 编 译 源码 .avi 


编译 Android 源码 的 方法 非常 简单 ， 只 需 使 用 Android 源码 根 目录 下 的 Makefile， 执 行 make 命令 
即 可 轻松 实现 。 当 然 在 编译 Android 源码 之 前 ,首先 要 确定 已 经 完成 同步 工作 。 进 入 Android 源码 目录 


(m, 
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使 用 make 命令 进行 编译 ， 使 用 此 命令 的 格式 如 下 : 
$: cd ас 4.3 (这 里 的 Android 4.3 就 是 我 们 下 载 源码 的 保存 目录 ) 
$: make 


编译 Android 源码 可 以 得 到 “~/project/android/cupcake/out” 目 录 , 笔者 的 截图 界面 如 图 2-13 所 示 。 


图 2-13 编译 过 程 的 界面 截图 
要 读者 耐心 等 待 。 


整个 编译 过 程 了 是非 
2.3.1 搭建 编译 环境 


在 编译 Android 源码 之 前 ， 需 要 先进 行 环境 搭建 工作 。 下 面 以 Ubuntu 系统 为 例 讲解 搭建 编译 环境 
以 及 编译 Android 源码 的 方法 ， 有 具体 流程 如 下 : 
(1) 安装 JDK， 编 译 Android 4.3 的 源码 需要 IDK 1.6， 下 载 jdk-6u22-linux-i586.bin 后 进行 安装 


对 应 命令 如 下 : 
$ cd /usr 
$ mkdir java 
$ cd java 
$ sudo cp jdk-6u22-linux-i586.bin 所 在 目录 ./ 
$ sudo chmod 755 jdk-6u22-linux-i586.bin 
$ sudo sh jdk-6u22-linux-i586.bin 
(2) WE IDK 环境 变量 , 将 如 下 环境 变量 添加 到 主 文件 夹 目录 下 的 .bashrc 文件 中 , 然后 用 source 
命令 使 其 生效 ， 加 入 的 环境 变量 代码 如 下 : 
export JAVA HOME-/usr/java/jdk1.6.0 23 
export JRE HOME-$JAVA HOME/jre 
export CLASSPATHz7.:$JAVA HOME/lib:$)RE HOME/lib:$CLASSPATH 
export PATH=$PATH:$JAVA_HOME/bin:$JAVA_HOME/bin/tools.jar:$JRE_HOME/bin 
export ANDROID JAVA HOME-$JAVA HOME 
(3) 安装 需要 的 包 ， 读 者 可 以 根据 编译 过 程 中 的 提示 进行 选择 ， 可 能 需要 的 包 的 安装 命令 如 下 : 
$ sudo apt-get install git-core bison zlib1g-dev flex libx12-dev gperf sudo aptitude install git-core gnupg flex 
bison gperf libsdl-dev libesd0-dev libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev 
© 
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2.3. 


2 开始 编译 


当 所 依赖 的 包 安 装 完成 之 后 ， 就 可 以 开始 编译 Android 源码 了 ， 具 体 步 骤 如 下 。 
(1) 进行 编译 初始 化 工作 ， 在 终端 中 执行 下 面 的 命令 : 

source build/envsetup.sh 

或 : 

. build/envsetup.sh 

执行 后 将 会 输出 : 

source build/envsetup.sh 

including device/asus/grouper/vendorsetup.sh 

including device/asus/tilapia/vendorsetup.sh 

including device/generic/armv7-a-neon/vendorsetup.sh 

including device/generic/armv7-a/vendorsetup.sh 

including device/generic/mips/vendorsetup.sh 

including device/generic/x86/vendorsetup.sh 

including device/samsung/maguro/vendorsetup.sh 

including device/samsung/manta/vendorsetup.sh 

including device/samsung/toroplus/vendorsetup.sh 

including device/samsung/toro/vendorsetup.sh 

including device/ti/panda/vendorsetup.sh 

including sdk/bash_completion/adb.bash 


(2) 选择 编译 目标 ， 命 令 如 下 : 
lunch = 


PLATFORM VERSION | CODENAME-REL 
PLATFORM VERSION-4.3 

TARGET. PRODUCT-full 
TARGET BUILD VARIANT-eng 
TARGET BUILD TYPE-release 

TARGET BUILD APPS- 

TARGET ARCH-arm 

TARGET ARCH VARIANTzarmv7-a 
HOST. ARCH-x86 

HOST OS-linux 

HOST OS EXTRA-Linux-2.6.32-45-generic-x86 64-with-Ubuntu-10.04-lucid 
HOST BUILD TYPE-release 

BUILD ID-JOP40C 

OUT DIR-ou 


G) 开始 编译 代码 ， 在 终端 中 执行 下 面 的 命令 : 


make -j4 


其 中 “-j4” 表 示 用 4 个 线程 进行 编译 。 整 个 编译 进度 根据 不 同 机 器 的 配置 而 需要 不 同 的 时 间 。 例 


如 笔者 电脑 为 intel i5-2300 四 核 2.8、4GB 内 存 ， 经 过 近 4 小 时 才 编 译 完 成 。 当 出 现下 面 的 信息 时 表示 
编译 完成 : 


target Java: ContactsTests (out/target/common/obj/APPS/ContactsTests_intermediates/classes) 
target Dex: Contacts 


@ 
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Done! 

Install: out/target/product/generic/system/app/Browser.odex 

Install: out/target/product/generic/system/app/Browser.apk 

Note: Some input files use or override a deprecated API. 

Note: Recompile with -Xlint:deprecation for details. 

Copying: out/target/common/obj/APPS/Contacts_intermediates/noproguard.classes.dex 

target Package: Contacts (out/target/product/generic/obj/APPS/Contacts intermediates/package.apk) 
'out/target/common/obj/APPS/Contacts intermediates/classes.dex' as 'classes.dex'... 

Processing target/product/generic/obj/APPS/Contacts intermediates/package.apk 

Done! 

Install: out/target/product/generic/system/app/Contacts.odex 

Install: out/target/product/generic/system/app/Contacts.apk 

build/tools/generate-notice-files.py out/target/product/generic/obj/NOTICE.txt out/target/product/generic/obj/ NOTICE. 

html "Notices for files contained in the filesystem images in this directory:" out/target/product/generic/obj/ 

NOTICE FILES/src 

Combining NOTICE files into HTML 

Combining NOTICE files into text 

Installed file list: out/target/product/generic/installed-files.txt 

Target system fs image: out/target/product/generic/obj/PACKAGING/systemimage intermediates/system.img 

Running: mkyaffs2image -f out/target/product/generic/system out/target/product/generic/obj/ PACKAGING/ 

systemimage intermediates/system.img 

Install system fs image: out/target/product/generic/system.img 

DroidDoc took 5331 sec. to write docs to out/target/common/docs/doc-comment-check 


2.8.3 ”在 模拟 器 中 运行 


在 模拟 器 中 运行 的 步骤 比较 简单 ， 只 需 在 终端 中 执行 下 面 的 命令 即 可 : 
emulator 


运行 成 功 后 的 效果 如 图 2-14 所 示 。 


图 2-14 在 模拟 器 中 的 编译 执行 效果 


234 ”常见 的 错误 分 析 
虽然 编译 方法 非常 简单 ， 但 是 作为 初学 者 来 说 很 容易 出 错 ， 下 面 列 出 了 其 中 常见 的 编译 错误 类 型 。 


(1) 缺少 必要 的 软件 
进入 到 Android 目录 下 ， 使 用 make 命令 编译 ， 可 能 会 出 现 如 下 错误 提示 。 


_@) 
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host C: libneo_cgi <= external/clearsilver/cgi/cgi.c 

external/clearsilver/cgi/cgi.c:22:18: error: zlib.h: No such file or directory 

上 述 错误 是 因为 缺少 zliblg-dev， 需 要 使 用 apt-get 命令 从 软件 仓库 中 安装 zliblg-dev， 具 体 命令 如 
下 所 示 。 

sudo apt-get install zlib1g-dev 

同 理 需 要 安装 下 面 的 软件 ， 和 否则 也 会 出 现 上 述 类 似 的 错误 。 

sudo apt-get install flex 

sudo apt-get install bison 

sudo apt-get install gperf 

sudo apt-get install libsdl-dev 

sudo apt-get install libesd0-dev 

sudo apt-get install libncurses5-dev 

sudo apt-get install libx12-dev 


(2) 没有 安装 Java 环境 IDK 

当 安 装 所 有 上 述 软件 后 ， 运 行 make 命令 再 次 编译 Android 源码 。 如 果 在 之 前 忘记 安装 Java 环境 
JDK， 则 此 时 会 出 现 很 多 Java 文件 无 法 编译 的 错误 ， 如 果 打 开 Android 的 源码 ， 可 以 看 到 在 目录 
android/dalvik/libcore/dom/src/test/java/org/w3c/domts 中 有 很 多 Java 源 文件 。 

这 充分 说 明 在 编译 Android 之 前 必须 先 安装 Java 环境 JDK， 安 装 流程 如 下 : 

从 Oracle 官方 网 站 下 载 jdk-6u16-linux-i586.bin 文件 ， 然 后 安装 。 

在 Ubuntu 8.04 中 ,/etc/profile 文件 是 全 局 的 环境 变量 配置 文件 , 它 适用 于 所 有 的 shell。 在 登录 Linux 
系统 时 应 该 先 启动 /etc/profile 文件 ， 然 后 再 启动 用 户 目 录 下 的 ~/.bash_profile、~/.bash_login 或 ~/.profile 
文件 中 的 其 中 一 个 , 执行 的 顺序 和 上 面 的 排序 一 样 。 如 果 ~/.bash_profile 文件 存在 , 则 还 会 执行 ~/bashrc 
文件 。 在 此 只 需要 把 IDK 的 目录 放 到 /etc/profile 目录 下 即 可 。 

JAVA HOME-/usr/local/src/jdk1.6.0 16 

PATH=$PATH:$JAVA_HOME/bin:/usr/local/src/android-sdk-linux_x86-1.1_r1/tools:~/bin 

М 重新 启动 机 器 ， 输 入 java -version 命令 ， 输 出 下 面 的 信息 则 表示 配置 成 功 。 

ava version "1.6.0_16" 

Java(TM) SE Runtime Environment (build 1.6.0 16-b01) 

Java HotSpot(TM) Client VM (build 13.2-b01, mixed mode, sharing) 

当成 功 编译 Android 源码 后 ， 在 终端 会 输出 如 下 提示 。 

Target system fs image: out/target/product/generic/obj/PACKAGING/systemimage_unopt_intermediates/ system.img 

Install system fs image: out/target/product/generic/system.img 

Target ram disk: out/target/product/generic/ramdisk.img 

Target userdata fs image: out/target/product/generic/userdata.img 

Installed file list: out/target/product/generic/installed-files. txt 

root@dfsun2009-desktop:/bin/android# 


2.3.5 ”实践 演练 一 一 演示 两 种 编译 Android 程序 的 方法 


Android 编译 环境 本 身 比 较 复杂 ， 并 且 不 像 普 通 的 编译 环境 那样 只 有 顶层 目录 下 才 有 Makefile X 
件 , 而 其 他 的 每 个 component 都 使 用 统一 标准 的 Android.mk 文件 。 不 过 这 并 不 是 我 们 熟悉 的 Makefile, 
而 是 经 过 Android 自身 编译 系统 的 很 多 处 理 。 所 以 说 要 真正 理 清 其 中 的 联系 还 比较 复杂 ， 不 过 这 种 方 
式 的 好 处 在 于 ， 编 写 一 个 新 的 Android.mk 给 Android 增加 一 个 新 的 Component 会 变 得 比较 简单 。 为 了 
使 读者 更 加 深入 地 理解 在 Linux 环境 下 编译 Android 程序 的 方法 , 下 面 将 分 别 演示 两 种 编译 Android 程 
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序 的 方法 。 
1. 编译 Native С (Ætt C 程序 ) 的 helloworld 模块 
编译 Java 程序 可 以 直接 采用 Eclipse 的 集成 环境 来 完成 , 实现 方法 非常 简单 ,在 这 里 就 不 再 重复 了 。 
接 下 来 将 主要 针对 C/C++ 进 行 说 明 ， 通 过 一 个 例子 来 讲解 在 Android 中 增加 一 个 С 程序 的 Hello World 
的 方法 。 
(1) 4E$(YOUR_ANDROID)/development 目录 下 创建 一 个 名 为 hello 的 目录 , 并 用 $(YOUR_NDROID) 
指向 Android 源 代码 所 在 的 目录 。 
-#mkdir $(YOUR_ANDROID)/development/hello 
(2) 在 目录 $(YOUR_ANDROID)/development/hello/ 下 编写 一 个 名 为 hello.c 的 C 语言 文件 ， 文 件 
hello.c 的 实现 代码 如 下 : 


#include <stdio.h> 
int main() 


printf("Hello WorldN\n");// 输 出 Hello World 
return 0; 
} 
(3) 在 目录 $(YOUR_ANDROID)/development/hello/ 下 编写 Android.mk 文件 。 这 是 Android Makefile 
的 标准 命名 ， 不 能 更 改 。 文 件 Android.mk 的 格式 和 内 容 可 以 参考 其 他 已 有 的 Android.mk 文件 的 写法 ， 
针对 helloworld 程序 的 Android.mk 文件 内 容 如 下 : 
LOCAL_PATH:= $(call my-dir) 
include $(CLEAR_VARS) 
LOCAL_SRC_FILES:=\ 
hello.c 
LOCAL_MODULE := helloworld 
include $(BUILD_EXECUTABLE) 
上 述 各 个 内 容 的 具体 说 明 如 下 。 
M LOCAL SRC FILES: 用 来 指定 源 文件 。 
М LOCAL MODULE: 指定 要 编译 的 模块 的 名 字 ， 在 下 一 步 编译 时 将 会 用 到 。 
M include $(BUILD_EXECUTABLE): 表示 要 编译 成 一 个 可 执行 文件 ， 如 果 想 编译 成 动态 库 则 可 
用 BUILD SHARED LIBRARY， 这 些 具 体 用 法 可 以 在 $(YOUR_ANDROID)/build/core/config.mk 
中 查 到 。 
(4) [BI] Android 源 代码 顶层 目录 进行 编译 。 
# cd $(YOUR_ANDROID) && make helloworld 
在 此 需要 注意 ，make helloworld 中 的 目标 名 helloworld 就 是 上 面 Android.mk 文件 中 由 LOCAL ` 
MODULE 指定 的 模块 名 。 最 终 的 编译 结果 如 下 : 
target thumb С: helloworld <= development/hello/hello.c 
target Executable: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/LINKED/ 
helloworld) 
target Non-prelinked: helloworld (out/target/product/generic/symbols/system/bin/helloworld) 
target Strip: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/helloworld) 
Install: out/target/product/generic/system/bin/helloworld 
C50 如 果 和 上 述 编译 结果 相同 ， 则 编译 后 的 可 执行 文件 存放 在 目录 out/target/product/generic/ 


system/bin/helloworld 中 。 
ə 
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这 样 通过 adb push 将 它 传送 到 模拟 器 上 ， 再 通过 adb shell 登录 到 模拟 器 终端 后 就 可 以 执行 了 。 
2. 手工 编译 C 模块 


在 前 面 讲解 了 通过 标准 的 Android.mk 文件 来 编译 C 模块 的 具体 流程 ， 其 实 我 们 可 以 直接 运用 gee 
命令 行 来 编译 C 程序 ， 这 样 可 以 更 好 地 了 解 Android 编译 环境 的 细节 。 具 体 流程 如 下 所 示 。 
(1) 在 Android 编译 环境 中 ， 提 供 了 showcommands 选项 来 显示 编译 命令 行 ， 可 以 通过 打开 这 个 
选项 来 查看 一 些 编译 时 的 细节 。 
(2) 在 具体 操作 之 前 需要 使 用 如 下 命令 把 前 面 的 helloworld 模块 清除 。 
# make clean-helloworld 
上 面 的 make clean-$(LOCAL MODULE) 命 令 是 Android 编译 环境 提供 的 make clean 的 方式 。 


(3) 使 用 showcommands 选项 重新 编译 helloworld， 具 体 命令 如 下 : 
# make helloworld showcommands 
build/core/product_config.mk:229: WARNING: adding test OTA key 
target thumb C: helloworld <= development/hello/hello.c 
prebuilt/linux-x86/toolchain/arm-eabi-4.3.1/bin/arm-eabi-gcc -| system/core/include -| hardware/libhardware/ 
include -| hardware/ril/include -| dalvik/libnativehelper/include -| frameworks/base/include -| external/ 
skia/include -| out/target/product/generic/obj/include -| bionic/libc/arch-arm/include -| bionic/libc/include 
-| bionic/libstdc++/include -| bionic/libc/kernel/common -| bionic/libc/kernel/arch-arm -| bionic/libm/ include -| 
bionic/libm/include/arch/arm -| bionic/libthread db/include -| development/hello -| out/target/product/generic/obj/ 
EXECUTABLES/helloworld intermediates -c -fno-exceptions -Wno-multichar -march-armv5te -mtune-xscale 
-msoft-float -fpic -mthumb-interwork -ffunction-sections -funwind-tables -fstack-protector-D ARM ARCH 5 __ 
-D ARM ARCH 5T -D ARM ARCH 5E -D ARM ARCH 5TE -include system/core/include/arch/ 
linux-arm/AndroidConfig.h -DANDROID -fmessage-length=0 -W -Wall -Wno-unused -DSK RELEASE 
-DNDEBUG -02 -g -Wstrict-aliasing=2 -finline-functions -fno-inline-functions-called-once -fgcse-after-reload 
-frerun-cse-after-loop -frename-registers -DNDEBUG -UDEBUG -mthumb -Os -fomit- frame-pointer 
-fno-strict-aliasing -finline-limit=64 -MD -o out/target/product/generic/obj/EXECUTABLES/ 
helloworld_intermediates/hello.o development/hello/hello.c 


target Executable: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/ 
helloworld) 


prebuilt/linux-x86/toolchain/arm-eabi-4.3.1/bin/arm-eabi-g++ -nostdlib -Bdynamic -WI,-T, build/core/armelf.x 
-WI,-dynamic-linker,/system/bin/linker -WI,--gc-sections -WI,-z,nocopyreloc -o out/target/product/generic/obj/ 
EXECUTABLES/helloworld intermediates/LINKED/helloworld -Lout/target/product/generic/obj/lib -WI,-rpath-link= 
out/ target/product/generic/obj/lib -Ic -Istdc++ -Im out/target/product/generic/obj/lib/crtbegin dynamic.o out/ 
target/ product/generic/obj/EXECUTABLES/helloworld intermediates/hello.o -WI,--no-undefined prebuilt/linux-x86/ 
toolchain/arm-eabi-4.3.1/bin/. /lib/gcc/arm-eabi/4.3.1/interwork/libgcc.a out/target/product/generic/obj/lib/crtend_ 
android.o 


target Non-prelinked: helloworld 
(out/target/product/generic/symbols/system/bin/helloworld) 


out/host/linux-x86/bin/acp -fpt out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/LINKED/ 
helloworld out/target/product/generic/symbols/system/bin/helloworld 


target Strip: helloworld (out/target/product/generic/obj/EXECUTABLES/helloworld intermediates/helloworld) 


out/host/linux-x86/bin/soslim --strip --shady --quiet out/target/product/generic/symbols/system/bin/helloworld 
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--outfile out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/helloworld 
Install: out/target/product/generic/system/bin/helloworld 


out/host/linux-x86/bin/acp -fpt out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/helloworld 

out/target/ product/generic/system/bin/helloworld 

从 上 述 命令 行 可 以 看 到 ，Android 编译 环境 所 用 的 交叉 编译 工具 链 如 下 : 

prebuilt/linux-x86/toolchain/arm-eabi-4.3.1/bin/arm-eabi-gcc 

其 中 参数 -I M-L 分 别 指定 了 所 用 的 C 库 头 文件 和 动态 库 文件 路 径 分 别 是 bionic/libe/include 和 
out/target/product/generic/obj/lib， 其 他 还 包括 很 多 编译 选项 以 及 -D 所 定义 的 预 编译 宏 。 

(4) 利用 上 面 的 编译 命令 来 手工 编译 helloworld 程序 ， 首 先 手 工 删除 上 次 编译 得 到 的 helloworld 
程序 。 

# rm out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/hello.o 

# rm out/target/product/generic/system/bin/helloworld 

然后 再 用 gec 编译 以 生成 目标 文件 。 

# prebuilt/inux-x86/toolchain/arm-eabi-4.3.1/bin/arm-eabi-gcc -I bionic/libc/arch-arm/include -I bionic/libc/ 

include -| bionic/libc/Kernel/common -I bionic/libc/Kernel/arch-arm -c -fno-exceptions -Wno-multichar -march= 

armv5te -mtune=xscale -msoft-float -fpic -mthumb-interwork -ffunction-sections -funwind-tables -fstack-protector 

-D ARM ARCH 5 -D_ARM_ARCH_5T_ -D ARM ARCH 5E -D_ARM_ARCH_5TE_ -include 

system/core/include/arch/linux-arm/AndroidConfig.h -DANDROID -fmessage-length=0 -W -Wall -Wno-unused 

-DSK RELEASE -DNDEBUG -O2 -g -Wstrict-aliasing=2 -finline-functions -fno-inline-functions-called-once 

-fgcse-after-reload -frerun-cse-after-loop -frename-registers -DNDEBUG -UDEBUG -mthumb -Os -fomit- 

frame-pointer -fno-strict-aliasing -finline-limit=64 -MD -o out/target/product/generic/ obj/EXECUTABLES/ 

helloworld intermediates/hello.o development/hello/hello.c 

如 果 此 时 与 Android.mk 编译 参数 进行 比较 ， 会 发 现 上 面 主要 减少 了 不 必要 的 参数 “-IT”。 

(5) 生成 可 执行 文件 。 

# prebuilt/linux-x86/toolchain/arm-eabi-4.3.1/bin/arm-eabi-gcc -nostdlib -Bdynamic -WI,-T,build/core/armelf.x 

-WI,-dynamic-linker,/system/bin/linker -WI,--gc-sections -WI,-z,nocopyreloc -o out/target/product/ generic/obj/ 

EXECUTABLES/helloworld_intermediates/LINKED/helloworld -Lout/target/product/generic/obj/lib -WI,-rpath-link- 

out/ target/product/generic/obj/lib -lc -Im out/target/product/generic/obj/EXECUTABLES/helloworld_ intermediates/ 

hello.o out/target/product/generic/obj/lib/crtbegin_dynamic.o -WI,--no-undefined./prebuilt/linux-x86/ toolchain/ 
arm-eabi-4.3.1/bin/. /lib/gcc/arm-eabi/4.3.1/interwork/libgcc.a out/target/product/generic/obj/lib/crtend android.o 

在 此 需要 特别 注意 的 是 参数 -Wl,-dynamic-linker,/system/bin/linker, 它 指定 了 Android 专用 的 动态 链 
接 器 是 /systemy/bin/linker， 而 不 是 平常 使 用 的 1d.so。 

(6) 使 用 命令 file 和 readelf 来 查看 生成 的 可 执行 程序 。 

# file out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld 

out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld: ELF 32-bit LSB 

executable, ARM, version 1 (SYSV), dynamically linked (uses shared libs), not stripped 

# readelf -d out/target/product/generic/obj/EXECUTABLES/helloworld_intermediates/LINKED/helloworld |grep 

NEEDED 

0x00000001 (NEEDED) Shared library: [libc.so] 
0x00000001 (NEEDED) Shared library: [libm.so] 

这 就 是 ARM 格式 的 动态 链接 可 执行 文件 ， 在 运行 时 需要 libe.so 和 libm.so。 当 提示 not stripped 时 
表示 它 还 没 被 STRIP (剥离 )。 嵌 入 式 系统 中 为 节省 空间 通常 将 编译 完成 的 可 执行 文件 或 动态 库 进行 剥 
离 ， 即 去 掉 其 中 多 余 的 符号 表 信息 。 在 前 面 make helloworld showcommands 命令 的 最 后 也 可 以 看 到 ， 
Android 编译 环境 中 使 用 了 out/host/linux-x86/bin/soslim 工具 进行 STRIP。 

® 
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2.4 编译 Android Kernel 


EN 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 2 章 \ 编 译 Android Kernel.avi 

编译 Android Kernel 代码 就 是 编译 Android 内 核 代码 ， 在 进行 具体 编译 工作 之 前 需要 先 了 解 在 
Android 开源 系统 中 包含 的 如 下 3 部 分 代码 。 

仿真 器 公共 代码 : 对 应 的 工程 名 是 kernel/common .get。 

MSM 平台 的 内 核 代码 : 对 应 的 工程 名 是 kemel/msm.get. 

ОМАР 平台 的 内 核 代 码 : 对 应 的 工程 名 是 kernel/omap.get. 

本 节 将 详细 讲解 编译 上 述 Android Kernel 的 基本 知识 。 


2.4.1 获取 Goldfish 内 核 代 码 


Goldfish 是 一 种 虚拟 的 ARM 处 理 器 ， 通 常 在 Android 的 仿真 环境 中 使 用 。 在 Linux 的 内 核 中 ， 
Goldfish 作为 ARM 体系 结构 的 一 种 “机 器 ”。 在 Android 的 发 展 过 程 中 , Goldfish 内 核 的 版 本 也 从 Linux 
2.6.25 升级 到 了 Linux 3.4， 此 处 理 器 的 Linux 内 核 和 标准 的 Linux 内 核 有 以 下 3 个 方面 的 差别 。 

回 Goldfish 机 器 的 移植 。 

М Goldfish 一 些 虚拟 设备 的 驱动 程序 。 

回 Android 中 特有 的 驱动 程序 和 组 件 。 

Goldfish 处 理 器 有 两 个 版 本 ， 分 别 是 ARMvS 和 ARMv7， 在 一 般 情况 下 ， 只 需 使 用 ARMvS 版 本 
即 可 。 在 Android 开源 工程 的 代码 仓库 中 ， 使 用 git 工具 得 到 Goldfish 内 核 代码 的 命令 如 下 : 

$ git clone git://android.git.kernel.org/kernel/common.git 

在 其 Linux 源 代码 的 根 目录 中 ， 配 置 和 编译 Goldfish 内 核 的 过 程 如 下 : 

$make ARCH=arm goldfish_defconfig .config 

$make ARCH=arm CROSS_COMPILE={path}/arm-none-linux-gnueabi- 

HH, CROSS COMPILE 的 path 值 用 于 指定 交叉 编译 工具 的 路 径 。 

编译 结果 如 下 : 

LD vmlinux 

SYSMAP system.map 

SYSMAP .tmp system.map 

OBJCOPY arch/arm/boot/Image 

Kernel: arch/arm/boot/Image is ready 

AS arch/arm/boot/compressed/head.o 

GZIP arch/arm/boot/compressed/piggy.gz 

AS arch/arm/boot/compressed/piggy.o 

CC arch/arm/boot/compressed/misc.o 

LD arch/arm/boot/compressed/vmlinux 

OBJCONPY arch/arm/boot/zlmage 

Kernel: arch/arm/boot/zlmage is ready 
M vmlinux: 是 Linux 进行 编译 和 连接 之 后 生成 的 Ef 格 式 的 文件 。 
Image: 是 未 经 过 压缩 的 二 进 制 文件 。 
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piggy: 是 一 个 解压 缩 程 序 。 

М zimage: 是 解压 缩 程 序 和 压缩 内 核 的 组 合 。 

在 Android 源 代码 的 根 目录 中 ,vmlinux 和 zImage 分 别 对 应 Android 代码 prebuilt 中 的 预 编译 的 arm 
内 核 。 使 用 zImage 可 以 蔡 换 prebuilt 中 的 prebuilt/android-arm/ 目 录 下 的 goldfish_defconfig， 此 文件 的 


主要 片段 如 下 : 
CONFIG_ARM=y 
# 
# System Type 
# 
CONFIG_ARCH_GOLDFISH=y 
# 
# Goldfish options 
# 
CONFIG_MACH_GOLDFISH=y 
# CONFIG_MACH_GOLDFISH_ARMV7 is not set 
因为 Goldfish 是 ARM 处 理 器 ， 所 以 CONFIG ARM 宏 需 要 被 使 能 ，CONFIG_ARCH GOLDFISH 
和 CONFIG MACH GOLDFISH fé Goldfish 处 理 器 这 类 机 器 使 用 的 配置 宏 。 
在 goldfish defconfig 中 ， 与 Android 系统 相关 的 宏 如 下 : 
# 
# android 
# 
CONFIG_ANDROID=y 
CONFIG_ANDROID_BUNDER_IPC=y #binder ipc 驱动 程序 
CONFIG_ANDROID_LOGGER=y #log 记录 器 驱动 程序 
# CONFIG_ANDROID_RAM_CONSOLE is not set 
CONFIG_ANDROID_TIMED_OUTPUT=y # 定 时 输出 驱动 程序 框架 
CONFIG_ANDROID_LOW_MEMORY_KILLER=y 
CONFIG_ANDROID_PMEM=y # 物 理 内 存 驱动 程序 
CONFIG_ASHMEM=y # 匿 名 共享 内 存 驱动 程序 
CONFIG_RTC_INTF_ALARM=y 
CONFIG_HAS_WAKELOCK=y 电源 管理 相关 的 部 分 wakelock 和 earlysuspend 
CONFIG_HAS_EARLYSUSPEND=y 
CONFIG_WAKELOCK=y 
CONFIG_WAKELOCK_STAT=y 
CONFIG_USER_WAKELOCK=y 
CONFIG_EARLYSUSPEND=y 


goldfish_defconfig 配置 文件 中 ,另外 有 一 个 宏 是 处 理 器 虚拟 设备 的 “驱动 程序 ” 其 内 容 如 下 所 示 。 
CONFIG_MTD_GOLDFISH_NAND=y 

CONFIG_KEYBOARD_GOLDFISH_EVENTS=y 

CONFIG_GOLDFISH_TTY=y 

CONFIG_BATTERY_GOLDFISH=y 

CONFIG_FB_GOLDFISH=y 

CONFIG_MMC_GOLDFISH=y 

CONFIG_RTC_DRV_GOLDFISH=y 


在 Goldfish 处 理 器 的 各 个 配置 选项 中 ， 体 系 结构 和 Goldfish 的 虚拟 驱动 程序 基于 标准 Linux 的 内 

容 的 驱动 程序 框架 ,但 是 这 些 设 备 在 不 同 的 硬件 平台 的 移植 方式 不 同 ; Android 专用 的 驱动 程序 是 
Android 中 特有 的 内 容 ， 非 Linux 标准 ， 但 是 和 硬件 平台 无 关 。 
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和 原 Linux 内 核 相 比 ,Android 内 核 增加 了 Android 的 相关 驱动 ,对 应 的 目录 是 kernel/drivers/android。 
主要 分 为 以 下 几 类 驱动 。 
Android IPC 系统 : Binder(binder.c). 
Android 日 志 系统 : Logger(logger.c). 
Android 电源 管理 : Power(power.c). 
Android [5] #22: Alarm(alarm.c). 
Android 内 存 控 制 台 : Ram console(ram console.c). 
Android 时 钟 控制 的 gpio: Timed gpio(timed gpio.c). 
对 于 本 书 讲解 的 驱动 程序 开发 来 说 ， 我 们 比较 关心 的 是 Goldfish 平台 下 相关 的 驱动 文件 ， 有 具体 说 

明 如 下 。 

(1) 字符 输出 设备 :kernel/drivers/char/goldfish_tty.c。 

(2) 图 像 显示 设备 (Frame Buffer): kernel/drivers/video/goldfishfb.c. 

G) 键盘 输入 设备 文件 : kernel/drivers/input/keyboard/goldfish_events.c。 

(4) RTC 设备 〈Real Time Clock) 文件 : kernel/drivers/rte/rte-goldfish.c. 

(5) USB Device 设备 文件 : kernel/drivers/usb/gadget/android_adb.c. 

(6) SD 卡 设备 文件 : kernel/drivers/mmc/host/goldfish.c o 

(7) FLASH 设备 文件 : kernel/drivers/mtd/devices/goldfish_nand.c, kernel/drivers/mtd/devices/goldfish_ 
nand reg.h。 

(8) LED 设备 文件 : kernel/drivers/leds/ledtrig-sleep.c o 

(9) 电源 设备 : kernel/drivers/power/goldfish battery.c. 

(10) 音频 设备 : kernel/arch/arm/mach-goldfish/audio.c o 

(11) Hi РИЙ: kernel/arch/arm/mach-goldfish/pm.c. 

(12) ВАР РЕ: kernel/arch/arm/mach-goldfish/timer.c o 


2.4» ”获取 MSM 内 核 代 码 


在 当前 市 面 中 ， 谷 歌 的 手机 产品 Gl 是 基于 MSM WE. MSM 是 高 通 公司 的 应 用 处 理 器 ， 在 
Android 代码 库 中 公开 了 对 应 的 MSM 的 源 代 码 。 在 Android 开源 工程 的 代码 仓库 中 ， 使 用 git 工具 得 
到 MSM 内 核 代码 的 命令 如 下 : 

$ git clone git://android.git.kernel.org/kernel/msm.git 


24.3 获取 OMAP 内 核 代码 


OMAP 是 德州 仪器 公司 的 应 用 处 理 器 ，Android 使 用 的 是 OMAP3 系列 的 处 理 器 。 在 Android 代码 


库 中 公开 了 对 应 的 MSM 的 源 代码 ， 使 用 git 工具 得 到 MSM 内 核 代码 的 命令 如 下 : 
$ git clone git://android.git.kernel.org/kernel/omap.git 


2.4.4 编译 Android 的 Linux 内 核 
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了 解 了 上 述 3 类 Android 内 核 后 , 下 面 开始 讲解 编译 Android 内 核 的 方法 。 在 此 假设 以 Ubuntu 8.10 


e. 


为 例 ， 完 整编 译 Android 内 核 的 流程 如 下 。 
(1) 构建 交叉 编译 环境 
Android 的 默认 硬件 处 理 器 是 ARM， 因 此 我 们 需要 在 自己 的 机 器 上 构建 交叉 编译 环境 。 交 叉 编译 
器 GNU Toolchain for ARM Processors 的 下 载 地 址 是 http://www.codesourcery.com/gnu toolchains/arm/ 
download.html。 
单 击 GNU/Linux 对 应 的 链接 ， 再 单 击 Download Sourcery CodeBench Lite 5.1 2012.02-117 链接 后 直 
接 下 载 ， 如 图 2-15 所 示 。 


Recommended Release 


This is a fully-velidated update to š previous release. This update contains corrections forimportant defects and other 
improvements. 


Download Sourcery CodeBench Lite 5.1 2012.03-117 


Available Releases 


This table lists allreleases for downoad. 


Release Target Platform | Status Date 
Sourcery CodeBench Lite 5.1 2012.03 117 GNU/Linux Update 20130923 
Sourcery CodeBench Lite 2012.03-104 GNU/Linux Update 2013-04-02 
Sourcery CodeBench Lite 2012.03-93 GNU/Linux Update 2012-11-19 
Sourcery CodeBench Lite 2012.03.66 GNU/Linux Release 2012-06-29 


215 ”下载 交 叉 编译 器 


把 arm-2008q2-72-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2 解压 到 一 个 目录 下 ， 例 如 ~/programes/， 
并 加 入 PATH 环境 变量 : 
vim -/.bashrc 


然后 添加 : 
ARM_TOOLCHIAN=~/programes/arm-2008q3/bin/ 
export PATH=${PATH}:${ARM_TOOLCHIAN}; 


保存 后 并 执行 : source ~/.bashre. 
(2) 获取 内 核 源码 
源码 地 址 是 http://code.google.com/p/android/downloads/list. 
选择 的 内 核 版 本 要 与 选用 的 模拟 器 版 本 尽量 一 致 。 下 载 并 解压 后 得 到 kernel.git 文件 夹 : 
tar -xvf -/download/linux-3.2.5-android-4.3 r1.tar.gz 
G) 获取 内 核 编 译 配置 信息 文件 
编译 内 核 时 需要 使 用 configure， 通 常 configure 有 很 多 选项 ， 我 们 往往 不 知道 需要 哪些 选项 。 在 运 
{т Android 模拟 器 时 ， 有 一 个 文件 /proc/config.gz， 这 是 当前 内 核 的 配置 信息 文件 ， 把 config.gz 获取 并 
解压 到 kernel.git 下， 然后 改名 为 .config。 命 令 如 下 : 
cd kernel.git/ 
emulator & 
adb pull /proc/config.gz 
gunzip config.gz 
mv config .config 
(4) 修改 Makefile 
修改 第 195 行 的 代码 : 
CROSS_COMPILE = arm-none-linux-gnueabi- 
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将 CROSS COMPILE 值 改 为 arm-none-linux-gnueabi-， 这 是 我 们 安装 的 交叉 编译 工具 链 的 前 绥 ， 
修改 此 处 意 在 告诉 make 在 编译 时 要 使 用 该 工具 链 。 然 后 注释 掉 第 562 和 563 行 的 如 下 代码 : 
#LDFLAGS BUILD ID = $(patsubst -WI$(comma)%,%,/ 
# $(call Id-option, -WI$(comma)-build-id,)) 
必须 将 上 述 代码 中 的 build-id 值 注释 掉 ， 因 为 目前 版 本 的 Android 内 核 不 支持 该 选项 。 
(5) 编译 
使 用 make 进行 编译 ， 并 同时 生成 гаре. 
LD arch/arm/boot/compressed/vmlinux 
OBJCOPY arch/arm/boot/zimage 
Kernel: arch/arm/boot/zImage is ready 
这 样 生成 zImage 大 小 为 1.23MB android-sdk-linux. x86-4.3 rl/tools/lib/images/kernel-qemu 是 
1.24MB. 
(6) 使 用 模拟 器 加 载 内 核 测试 
其 命令 如 下 : 
cd android/out/cupcake/out/target/product/generic 


emulator -image system.img -data userdata.img -ramdisk ramdisk.img -kernel ~/project/android/kernel.git/arch/ 
arm/boot/zImage & 


至 此 ， 模 拟 器 加 载 成 功 。 


2.5 43 Android 应 用 开发 环境 


Фин 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 2 章 \ 搭 建 Android 应 用 开发 环境 .avi 
Android SDK 是 开发 Android 应 用 程序 所 必须 具备 的 工具 , 在 搭建 之 前 需要 先 确定 基于 Android 应 
用 软件 所 需要 开发 环境 的 要 求 ， 具 体 如 表 2-1 所 示 。 
表 2-1 开发 系统 所 需求 参数 
项 目 版 本 要 求 说 а 备注 


Windows XP 以 上 或 
操作 Vista Mac OS X 


: 根据 自己 的 电脑 自行 选择 选择 自己 最 熟悉 的 操作 系统 
系统 10.4.8+Linux Ubuntu 
Drapper 以 上 
软件 开 š 
发 包 Android SDK 选择 最 新 版 本 的 SDK 截止 到 目前 , 最 新 手机 版 本 是 5.0 


Eclipse3.3(Europa) ， 3.4(Ganymede)ADT(Android 


选择 for Java Developer 
Development Tools) 开 发 插件 р 


IDE Eclipse IDE+ADT 


(单独 的 IRE 是 不 可 以 的 ， 必 
须要 有 IDK), 不 兼容 Спи Java 
编译 器 (gcj) 


Java SE Development Kit 5 或 6Linux 和 Mac 上 使 


其 他 | IDK Apache Ant 
чай 用 Apache Ant 1.6.5+, Windows 上 使 用 1.7+ 版 本 


Android 工具 是 由 多 个 开发 包 组 成 的 ， 具 体 说 明 如 下 。 
JDK: 可 以 到 网 址 http://java.sun.com/javase/downloads/index.jsp 处 下 载 。 
Eclipse (Europa): 可 以 到 网 址 http://www.eclipse.org/downloads/ T £X Eclipse IDE for Java Developers. 


(s, 


жов жаласа ята ОО 


Android SDK: 可 以 到 网 址 http://developer.android.com F 4X. 


М ”还 有 对 应 的 开发 插件 。 


2.5.1 安装 JDK 


JDK (Java Development Kit) 是 整个 Java 的 核心 ， 包 括 了 Java 运行 环境 、Java 工具 和 Java 基础 的 
类 库 。JDK 是 学 好 Java 的 第 一 步 ， 是 开发 和 运行 Java 环境 的 基础 ， 当 用 户 要 对 Java 程序 进行 编译 时 ， 
必须 先 获得 对 应 操作 系统 的 JDK， 否 则 将 无 法 编译 Java 程序 。 在 安装 IDK 之 前 需要 先 获得 ТОК, ЯК 


得 IDK 的 操作 流程 如 下 : 


(1) 登录 Oracle 官方 网 站 ， 网 址 为 http://developers.sun.com/downloads/， 如 图 2-16 所 示 。 


Downloads | Store | Support Training Partners About > 
Databases Server and Storage Systems 

Database 11g Sours 

Database 11g Release 2 ax and Vit 

Express tonon fosse 

муза. Hide 

Berkeley 08 

san cient Developer Toots msa 

Apalicalon tapress SCALE Fusion Middeware ig 

ser А Daabate 119 

s JDevekcerand ADF 

Develoger Tool for Visual Sudie et Deeper vs 

тое Enterprse Pack tor Ecipse 

Fusion iddewars 110 m 

(incl WebLogic) — M Free Open Source Software 

JReckt а Partner Demo Software 

ne » 

p E-Business Sute 

Pecolesoft JD Edwards 

Enterpnse Management Stee CRM 

Enterprae Manager Age 

Арисаюп Testng Sute Autovue 


图 2-16 Oracle 官方 下 载 页 面 


(2) 在 图 2-16 中 可 以 看 到 有 很 多 版 本 ,在 此 选择 当前 最 新 的 版 本 Java 7， 下 载 页 面 如 图 2-17 所 示 。 


(3) 在 图 2-17 中 单 击 IDK 下 方 的 Download 按钮 ， 在 弹出 的 新 界面 中 选择 将 要 下 载 的 JDK， 笔 
者 在 此 选择 的 是 Windows x86 版 本 ， 如 图 2-18 所 示 。 


Java SE Development Kit7u1 
дама Platform, Standard Edition 
You must accept the Oracle Binary Code License. Aor Java SE to download this 
software. 
Java SE7u1 оок JRE 
Thie releve includes many securo. Leom e 人 
"What Java Do | Need?" You must have а copy of 207 Docs ЖЕТ Doce 
тле JRE (Java Runtime Environment) on your + installation + installation ms ELT obe 
ystomto run Java cppications and applets. то" рр Кетет Linux 186 772748 Š jok-7u1-inux-586 pm 
develop Java applications and applets, you need Linux x86 9217 МВ Š jók-7u1-linuxi586 tar. oz 
the JDK (Java Development КЇ), which includes = ReadMe * Reade Linux x64 7791 MB Š үск-гил-йихлбалрт 
the JRE, Linux x64 9157 MB 8 jók 70110264 br g: 
kusana | Solaris 186 15478MB Š jck-7u1-solaris-596.terZ 
+ OradeLicense = DradeLicense Solaris 186 9475МВ Š jok-7u1-solaris1586 tar gz 
р Д Soans SPARC 157.81MB Ж jok-7ut-solaris-sparciarZ 
E mem Solaris SPARC 90.49 MB Š jd 7u1 solanə spere or g: 
= Solaris SPARC 64-bit 16.27 МВ Š jai-Tu1-solaris-sparo taZ 
° Third Party = Solaris SPARC 64-bit 1237 МВ $ jok-7ut-solaris-spar9 targz 
Licenses Lk ‘Solaris x64 1468 MB $ jdi-Tu1-solaris-x64 tar Z 
= Cerifed System |- Cerified System Solarisx64 Фзамв Š jok-7u1-solans x84 tar. 
Contguratons Configurations Windows x86 79.45 MB Š jok-7u1-wndows-586 exe 
Windows x64 80.24 MB Š jck-7u1-windows-164 exe 


图 2-17 IDK 下 载 页 面 图 2-18 选择 Windows x86 版 本 
(4) 下 载 完成 后 双击 下 载 的 .exe 文件 开始 进行 安装 ， 将 弹出 “安装 向 导 ” 对 话 框 ， 在 此 单 击 “ 下 


一 步 ” 按 钮 ， 如 图 2-19 所 示 。 
© 


Android 物 联 网 开发 从 入 门 到 实战 


(5) 弹出 “安装 路 径 ” 对 话 框 ， 在 此 选择 文件 的 安装 路 径 ， 如 图 2-20 所 示 。 
ig Tava (ТИ) SE Developaent Kit T Update i isle SE Developme: VEE xj 
4 
2 java ORACLE — 
欢迎 使 用 Java(TM) SE Development Kit 7 Update 1 8819 请 从 下 面 的 列 衣 中 这 将 委 安 装 的 可 这 功能 。 安 装 完成 后 ， 交 可 以 使 用 "控制 面板 "中 的 "添加 / 
SES TERS нога 
Бы 
ERI aL PE ad 
Java(TM) SE Development Kit 7 Update 1 Ede ERESERAS , SHASH FORO. RÀ 
ЗИ ЕНЕНЕ FEAR NER, aA. FOSE таалан 
ERA. 


C:Program Faes\lava\ice1.7.0_01\ 


taro eee (Se) <&-®® Lr] 
图 2-19 “安装 向 导 ” 对 话 框 图 2-20 “安装 路 径 ” 对 话 框 
单 击 “ 下 一 步 ”按钮 开始 在 安装 路 径 解压 缩 下 


(6) 在 此 设置 安装 路 径 是 “E:\jdk1.7.0_01\”， 然 后 单 击 “ 
安装 的 位 置 ， 如 图 2-22 所 示 。 


载 的 文件 ， 如 图 2-21 所 示 。 
(7) 完成 后 弹出 “目标 文件 夹 ”对 话 框 ， 在 此 选择 要 
П Teva (ТВ) SE De Kit 7 Update 1 > BEE Tere 


вт T-#0> 
“目标 文件 夹 ”对 话 框 


图 2-22 


图 2-21 解压 缩 下 载 的 文件 
(8) 单 击 “ 下 一 步 ” 按 钮 后 开始 正式 安装 ， 如 图 2-23 所 示 。 
(9) 完成 后 弹出 “完成 ”对 话 框 ， 单 击 “ 完 成 ”按钮 后 完成 整个 安装 过 程 ， 如 图 2-24 所 示 。 


mt Kit T Update 1 > 完成 


ici xi] 


ORAcLE 


Java(TM) SE Development Kit 7 Update 1 已 成 功 安装 
通知 服务 


SER ， 同 时 显示 ]DK 产品 注册 表单 。 如 果 您 


3 Billion Devices Run Java 
有 关注 册 所 收集 的 痢疾 以 及 这 芷 数据 的 管理 和 使 用 方式 的 更 多 信息 ,请 参见 产品 
注册 信息 页面。 
FREER O 
eee) ] 
图 2-24 完成 安装 


图 2-23 ”继续 安装 


#2 #2 Android 开发 环境 
注意 : 完成 安装 后 可 以 检测 是 否 安装 成 功 ， 方 法 是 选择 “开始 ” | “运行 ”命令 ， 在 弹出 的 对 话 框 中 
输入 “cmd” 并 按 Enter 键 , 在 打开 的 CMD 窗口 中 输入 “java-version”， 如 果 显 示 如 图 2-25 所 
示 的 提示 信息 ， 则 说 明 安 装 成 功 。 


«ТМ» SE 


ent Cbuilé 
HotSpot СТМ» Client UM 《bu 


sharing? 


图 2-25 CMD 窗口 


如 果 检 测 到 没有 安装 成 功 ， 需 要 将 其 目录 的 绝对 路 径 添加 到 系统 的 PATH 中 。 有 具体 做 法 如 下 : 
CD 右 击 “ 我 的 电脑 ”图 标 ， 并 选择 “属性 ” 命 
击 “ 环 境 变 量 ” 按 钮 ， 然 后 单 击 “ 系 统 变 


ка.» 


令 ， 在 弹出 的 对 话 框 中 选择 “高 级 ”选项 卡 ， 单 
量 ” 栏 中 的 “新 建 ” 按 钮 ， 在 弹出 对 话 框 的 “变量 名 ”文本 
框 中 输入 “JAVA_HOME ”， 在 “变量 值 ” 文 本 框 中 输入 刚才 的 目录 ， 如 设置 为 “C:\Program Files\Java\ 
jdk1.7.0_01”， 如 图 2-26 所 示 。 
(2) 再 次 新 建 一 个 变量 名 为 classpath， 其 变量 值 如 下 所 示 。 
.;%JAVA_HOMEW%/lib/rt.jar;%JAVA_HOME%/lib/tools.jar 

单 击 “ 确 定 ” 按 钮 找到 PATH 的 变量 ， 双 击 或 单 击 编辑 ， 在 变量 值 
%JAVA_HOME%/bin; 


i 最 前 面 添加 如 下 值 。 
具体 如 图 2-27 所 示 。 
ШЫП ЫЕ! 
Re wD w 变量 名 0D [ыры 
EQ: Free ruasqa 1001 жашо 
Lr] 


Tb/rt. jar JAVA HOMER/Lib/ tools. jar 


[ах ] x» | 


图 2-26 设置 系统 变量 
(3) 再 选择 “开始 ”| “运行 


= AA 
命令 


图 2-27 设置 系统 变量 


， 在 弹出 的 对 话 框 中 输入 “cmd” 并 按 Enter 键 ， 在 打开 的 
CMD 窗口 中 输入 “java-version”， 如 果 显 示 如 图 2-28 所 示 的 提示 信息 


\， 则 说 明 安装 成 功 。 


tings Adninistrator>java 


ironment 《build 1.7.0_01-b08)> 
UM Chuild 21.1-b02, 


mixed mode, sharing? 


图 2-28 CMD 窗口 


注意 : 上 述 变量 设置 中 ， 是 按照 笔者 本 人 的 安装 路 径 设置 的 ， 笔 者 安装 的 IDK 的 路 径 是 C:\Program 
Files\Java\jdk1.7.0_ 01. 
2.5.2 ”获取 并 安装 Eclipse 和 Android SDK 
在 安装 好 JDK 后 , 接 下 来 需要 安装 Eclipse 和 Android SDK. Eclipse 是 进行 Android 应 用 开发 的 一 


9) 


Быел 


个 集成 工具 , 而 Android SDK 是 开发 Android 应 用 程序 锁 必 须 具备 的 框架 。 在 Android 官方 公布 的 最 新 
版 本 中 ， 已 经 将 Eclipse 和 Android SDK 这 两 个 工具 进行 了 集成 ， 一 次 下 载 即 可 同时 获得 这 两 个 工具 。 
获取 并 安装 Eclipse 和 Android SDK 的 具体 步骤 如 下 : 
(1) 登录 Android 的 官方 网 站 http://developer.android.com/index.html, ЎТ 2-29 所 示 。 


Developers Design Develop Distribute а 


Android 5.0 Lollipop 

The Android 5 update adds a variety of 
new features for your apps. such аз 
rotfeations on the lock sereen. an al new 
camera APL OpenGL ES 31. the new 
Matenal design interface, and much more 


Building Apps for Creating Apps with Android Studio 
Wearables Material Design Laam at be wen arin te 
Learn how to bude! тйк. ations, send ‘Lean how to apply materal denga to bata reese of our aw DE. 
= == 


2-29 Android 的 官方 网 站 
(2) 单 击 中 部 的 Get the SDK 链接 ， 如 图 2-30 所 示 。 


Get the SDK » Browse Samples > Watch Videos > Manage Your Apps › 


Р 2-30 žit Get the SDK 链接 
(3) 在 弹出 的 新 页 面 中 单 击 Download the SDK 按钮 ， 如 图 2-31 所 示 。 


"Developers ~ — Design Develop Distribute а 

Training — APIGuides — Reference Tools Google Services 

Developer Tools. Get the Android SDK 

Download 
The Android SOK provides you the API libraries and 

‘Setting Up the ADT developer tools necessary to build. test. and debug 

Bundle apps for Android. 

Setting Up an 

eee i youre a new Android developer, we recommend you 


download the ADT Bundle to quickly start developing 
apps. Н includes the essential Android SDK 
Exploring the SDK ‘components and a version of the Eclipse IDE with 

built-in ADT (Android Developer Tools) to streamline 
Bownload the NOK | your Android app development, 


Android Studio. 


Workflow With a single download, the ADT Bundle includes. 
everything you need to begin developing apps: 

* Eclipse + ADT plugin 

* Android SDK Tools. 


Support Library 


Teale He 
2-31 X Download the SDK 按钮 


(4) 在 弹出 的 Get the Android SDK 界面 中 选中 І have read and agree with the above terms and 
conditions 复 选 框 ， 然 后 在 下 面 的 单 选 按钮 中 选择 系统 的 位 数 。 例 如 笔者 的 机 器 是 32 位 的 ， 所 以 选中 
32-bit 单 选 按钮 ， 如 图 2-32 所 示 。 


(5) 单 击 图 2-32 中 的 EEC 拉 钮 后 开始 下 载 工作 ， 下 载 的 目标 文件 是 一 个 压缩 包 ， 如 
图 2-33 所 示 。 


Developer Tools 
Download ^ 


Setting Up the ADT 
Bundle 


Setingupan ~ 
Existing IDE 


Android Studio 
Exploring the SOK 
Download the NOK 
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Get the Android SDK 


Before installing the Android SDK you must agree to the following terms and conditions 


1274ndroid means the Android software stack for devices. es made avilable under the Android Open Source. 
Project, which is located at the folowing URL htt //source android com, as updated from time o time. 


1 3"Google" means Google iae.. Deleware corporation wth principai place of business at 1600 Amphitheatre 
Parkway. Mountain View. СА 94048, United States 

2. Accepting this License Agreement 

2 1 In order to use the SOK. you must first agree to this License Agreement. You may not use the SOK i you do no 
acceptis License Agreement 

22 By licking to accept you hereby agree to the tems of this License Agreement. 

23 You may not use the SDK and may not accept the License Agreement t you are a person barred from receiving 
the SOK under the av of the United States or other counties including he country n which you ме resident or 
fom wisch you use the SDK 


2 4 you are agreeing to be bound by this License Agreement on behalf of your employer or ather entity you 


Ff i have read and agree with the above terms and conditions 


= зы сыы 


2-32 Get the Android SDK 界面 


(6) 将 下 载 得 到 的 压缩 包 进行 解压 ， 解 压 后 的 目录 结构 如 图 2-34 所 示 。 


[Ттт Ж 


poen] wows tenet7 zn 
Z MAP EFRY 


SS eee 


д id c mman p SEE] 
prd: 
[E 
emma 
таван 
CIE ARINAETSE 
тта 
^ [шй “] юй 


图 2-33 开始 下 载 目标 文件 压缩 包 


回 SUK Manager. exe 


2014/10/14 8:51 XR 
2014/10/18 16:28 SUPE 
2014/1/3 3:24 应 用 程序 216 КВ 


图 2-34 解压 后 的 目录 结构 


由 此 可 见 , Android 官 方 已 经 将 Eclipse #1 Android SDK 实现 了 集成 ,双击 eclipse 目录 中 的 eclipse.exe 


可 以 打开 Eclipse， 界 面 效 果 如 图 2-35 所 示 。 


Wa deter Sree Rente ee Propet Ме Me быр 


EP wt eT Prone eee erm 


5 тоже ЕС 
Ө соте tt авама -г-- в 
Е a 


EE. LES 


-35 ”打开 Eclipse 后 的 界面 效果 


物 联网 开发 从 入 门 到 实战 


(7) 打开 Android SDK 的 方法 有 两 种 ， 第 一 种 是 双击 下 载 目录 中 的 SDK Managerexe 文件 ， 第 二 
种 是 在 Eclipse 工具 栏 中 单 击 轧 图 标 。 打 开 后 的 效果 如 图 2-36 所 示 。 
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I al 
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图 2-36 打开 Android SDK 后 的 界面 效果 
2.5.8 ”快速 安装 SDK 


通过 Android SDK Manager 在 线 安 装 的 速度 非常 慢 ， 而 且 有 时 容易 挂 掉 。 其 实 我 们 可 以 先 从 网 络 
中 寻找 到 SDK 资源 ， 用 迅雷 等 下 载 工 具 下 载 后 ， 将 其 放 到 指定 目录 后 就 可 以 完成 安装 。 有 具体 方法 是 先 
下 载 android-sdk-windows， 其 可 以 更 新 ， 然 后 在 android-sdk-windows 下 双击 setup.exe， 在 更 新 的 过 程 
中 会 发 现 安装 Android SDK 的 速度 是 1Kb/s， 此 时 打开 迅雷 ， 分 别 输入 下 面 的 地 址 : 
https://dl-ssl.google.com/android/repository/platform-tools_r05-windows.zip 
https://dl-ssl.google.com/android/repository/docs-3.1_r02-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.2_r02-windows.zip 
https://dl-ssl.google.com/android/repository/android-2.3.3 r02-linux.zip 
https://dl-ssl.google.com/android/repository/android-2.1_102-windows.zip 
https://dl-ssl.google.com/android/repository/samples-2.3.3 r02-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.2 r02-linux.zip 
https://dl-ssl.google.com/android/repository/samples-2.] r02-linux.zip 
https://dl-ssl.google.com/android/repository/compatibility r02.zip 
https://dl-ssl.google.com/android/repository/tools r12-windows.zip 
https://dl-ssl.google.com/android/repository/google apis-10 r02.zip 
https://dl-ssl.google.com/android/repository/android-2.3.1 r02-linux.zip 
https://dl-ssl.google.com/android/repository/usb driver r04-windows.zip 
https://dl-ssl.google.com/android/repository/googleadmobadssdkandroid-4.1.0.zip 
https://dl-ssl.google.com/android/repository/market licensing-r01.zip 


q Ж е н наа АНАНАН саса] 
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https://dl-ssl.google.com/android/repository/market billing r01.zip 
https://dl-ssl.google.com/android/repository/google apis-8 r02.zip 
https://dl-ssl.google.com/android/repository/google apis-7 rOl.zip 
https://dl-ssl.google.com/android/repository/google apis-9 r02.zip 


ева 


可 以 继续 根据 自己 的 开发 要 求 选择 不 同 版 本 的 API。 
下 载 完 后 将 它们 复制 到 android-sdk-windows/Temp 目录 下 , 然后 再 运行 setup.exe， 选 中 需要 的 APT 
选项 ， 完 成 安装 。 记 得 保留 原始 文件 ， 因 为 放 在 temp 目录 下 的 文件 装 好 后 立刻 会 消失 。 
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Android 为 Eclipse 定制 了 一 个 专用 插件 Android Development Tools (ADT)， 此 插件 为 用 户 提供 了 

一 个 强大 的 开发 Android 应 用 程序 的 综合 环境 .ADT 扩展 了 Eclipse 
的 功能 , 可 以 让 用 户 快 速 地 建立 Android 项 目 , 创建 应 用 程序 界面 。 
要 安装 Android Development Tools plug-in， 需 要 首先 打开 Eclipse 
IDE， 然 后 进行 如 下 操作 : 

(1) 打开 Eclipse 后 ， 依 次 选择 菜单 栏 中 的 Help | Install New 
Software 命令 ， 如 图 2-37 所 示 。 

(2) 在 弹出 的 对 话 框 中 单 击 Add 按钮 ， 如 图 2-38 所 示 。 

(3) 在 弹出 的 Add Site 对 话 框 中 分 别 输入 名 字 和 地 址 ， 名 字 
可 以 自己 命名 , 例如 “123”， 但 是 在 Location 中 必须 输入 插件 的 网 
络 地 址 http://dl-ssl.google.com/Android/eclipse/， 如 图 2-39 所 示 。 2-37 ”添加 插件 

(4) 单 击 OK 按钮 ， 此 时 在 Install 窗口 将 会 显示 系统 中 可 用 
的 插件 ， 如 图 2-40 所 示 。 


图 2-38 ”添加 插件 


图 2-39 设置 地 址 


Available Software 
Check the itens that you wish to install. 


‘con/Andr oid/ eclipse/ 


0.9.5. v200911191123-20404 
B+ Android Development Tools O 9 S v200911191123-20404 


图 2-40 ”插件 列表 


(5) 选中 Android DDMS 和 Android Development Tools 复 选 框 ， 然 后 单 击 Next 按钮 进入 安装 界 
面 ， 如 图 2-41 所 示 。 


зуп Connector? Баста 
ууа Task List Maguirea) [components at 
E hylyn Taci-Feoused Interface бөз... . yj mdr it bernal асов бедата 
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图 2-41 插件 安装 界面 


(6) 选中 Iacceptthe terms of the license agreements 单 选 按钮 ， 单 击 Finish 按钮 ， 开 始 进行 安装 ， 
如 图 2-42 所 示 。 
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图 2-42 开始 安装 


注意 : 在 步骤 (6) 中 ， 可 能 会 发 生计 算 插件 占用 资源 情况 ， 过 程 有 点 慢 。 完 成 后 会 提示 重启 Eclipse 
来 加 载 插件 ， 等 重启 后 就 可 以 用 了 。 并 且 不 同 版 本 的 Eclipse 安装 插件 的 方法 和 步骤 是 不 同 的 ， 
但 是 都 大 同 小 异 ， 读 者 可 以 根据 操作 提示 自行 解决 。 


255 ”验证 设置 

经 过 本 章 前 面 内 容 的 介绍 ， 已 经 讲解 了 搭建 安装 Android 基本 环境 的 知识 。 在 完成 安装 之 后 ， 还 
需要 一 些 具 体验 证 和 设置 工作 。 本 节 将 详细 讲解 验证 和 设置 Android 开发 环境 的 基本 知识 。 

1. 设 定 Android SDK Home 


当 完 成 上 述 插件 装备 工作 后 , 此 时 还 不 能 使 用 Eclipse 创建 Android 项 目 , 还 需要 在 Eclipse 中 设置 
Android SDK 的 主 目录 。 
(1) 打开 Eclipse， 在 菜单 中 选择 Window | Preferences 命令 ， 如 图 2-43 所 示 。 
(2) 在 弹出 的 界面 左 侧 选择 Android 节点 后 ， 在 右 侧 设 定 Android SDK 所 在 目录 为 SDK Location, 
单 击 OK 按钮 完成 设置 ， 如 图 2-44 所 示 。 
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2-43 Preferences 命令 2-44 选择 Android 节点 
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2. 验证 开发 环境 


经 过 前 面 步骤 的 讲解 ， 一 个 基本 的 Android 开发 环境 搭建 完成 了 。 都 说 实践 是 检验 真理 的 唯一 标 
准 ， 下 面 通过 新 建 一 个 项 目 来 验证 当前 的 环境 是 否 可 以 正常 工作 。 
(1) 打开 Eclipse， 在 菜单 中 选择 File | New | Project 命令 ， 弹 出 的 窗口 如 图 2-45 所 示 。 
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2-45 新建 项 目 
(2) 在 图 2-45 中 选择 Android 节点 ， 单 击 Next 按钮 后 打开 New Android Application 窗口 ， 在 对 
应 的 文本 框 中 输入 必要 的 信息 ， 如 图 2-46 所 示 。 
C3) "fcit Finish 按钮 后 Eclipse 会 自动 完成 项 目的 创建 工作 , 最 后 会 看 到 如 图 2-47 所 示 的 项 目 结构 。 
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256 ”创建 Android 虚拟 设备 《AVD) 


程序 开发 需要 调试 ， 只 有 经 过 调试 之 后 才能 知道 程序 是 否 正确 运行 。 作 为 一 款 手机 系统 ， 我 们 怎 
么 样 才 能 在 电脑 平台 之 上 调试 Android 程序 呢 ? 不 用 担心 ， 谷 歌 为 我 们 提供 了 模拟 器 来 解决 我 们 担心 
的 问题 。 所 谓 模 拟 器 ， 就 是 指 在 电脑 上 模拟 安 卓 系统 ， 可 以 用 这 个 模拟 器 来 调试 并 运行 开发 的 Android 


@ 
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程序 。 开 发 人 员 不 需要 一 个 真实 的 Android 手机 ， 只 通过 电脑 即 可 模拟 运行 一 个 手机 ， 即 可 开发 出 应 


用 在 手机 上 面 的 程序 。 
AVD 全 称 为 Android 虚拟 设备 (Android Virtual Device)， 每 个 AVD 模拟 了 一 套 虚 拟 设 备 来 运行 


Android 平台 ， 这 个 平台 至 少 要 有 自己 的 内 核 、 系 统 图 像 和 数据 分 区 ， 还 可 以 有 自己 的 SD 卡 和 用 户 数 


据 以 及 外 观 显示 等 。 创 建 AVD 的 基本 步骤 如 下 : 
(1) 单 击 Eclipse HA PHAR, Wil 2-48 所 示 。 
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图 2-48 Eclipse 
(2) 在 弹出 的 Android Virtual Device (AVD) Manager 界面 中 选择 Android Virtual Devices 选项 卡 ， 
如 图 2-49 所 示 。 
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2-49 Android Virtual Device (AVD) Manager 界面 
在 Android Virtual Devices 选项 卡 中 列 出 了 当前 已 经 安装 的 AVD 版 本 ， 我 们 可 以 通过 右 侧 的 按钮 


来 创建 、 删 除 或 修改 AVD。 主 要 按钮 的 具体 说 明 如 下 。 
ы [esse]. 创建 一 个 新 的 AVD， 单 击 此 按钮 在 弹出 的 界面 中 可 以 创建 一 个 新 AVD， 如 图 2-50 


所 示 。 
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图 2-50 Ж AVD 界面 


: 修改 已 经 存在 的 AVD。 

: 删除 已 经 存在 的 АУР. 

: 启动 一 个 AVD 模拟 器 。 

注意 : 可 以 在 CMD 中 创建 或 删除 AVD， 例如 可 以 按照 如 下 CMD 命令 创建 一 个 AVD。 


android create avd --name <your avd name> --target <targetID> 
其 中 ，your avd name 是 需要 创建 的 AVD 4 4F, 在 CMD 界面 中 如 图 2-51 所 示 。 
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图 2-51 CMD 界面 


257 ”启动 AVD 模拟 器 

对 于 Android 程序 的 开发 者 来 说 ， 模 拟 器 的 推出 给 开发 者 在 开发 上 和 测试 上 带 来 了 很 大 的 便利 。 
无 论 在 Windows 下 还 是 Linux F, Android 模拟 器 都 可 以 顺利 运行 。 并 且 官 方 提供 了 Eclipse 插件 ， 可 
以 将 模拟 器 集成 到 Eclipse 的 IDE 环境 。Android SDK 中 包含 的 模拟 器 的 功能 非常 齐全 ， 电 话 本 、 通 话 
等 功能 都 可 正常 使 用 (当然 用 户 没 办 法 真 的 从 这 里 打 电话 ), 甚至 其 内 置 的 浏览 器 和 Maps 都 可 以 联网 。 
户 可 以 使 用 键盘 输入 ， 单 击 模拟 器 按键 输入 ， 甚 至 还 可 以 使 用 鼠标 单 击 、 拖 动 屏幕 进行 操作 。 模 拟 
器 在 电脑 上 模拟 运行 的 效果 如 图 2-52 所 示 。 

1. 模拟 器 和 真 机 究竟 有 何 区 别 

当然 Android 模拟 器 不 能 完全 替代 真 机 ， 具 体 来 说 有 如 下 差异 。 

模拟 器 不 支持 呼叫 和 接听 实际 来 电 ， 但 可 以 通过 控制 台 模 拟 电 话 呼叫 〈 呼 入 和 呼出 )。 

M BRA x USB 连接 。 
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图 2-52 模拟 器 


Ы ”模拟 器 不 支持 相机 /视频 捕捉 。 
回 “ 模 拟 器 不 支持 音频 输入 〈 捕 捉 )， 但 支持 输出 〈 重 放 )。 
М ”模拟 器 不 支持 扩展 耳机 。 
加 ”模拟 器 不 能 确定 连接 状态 。 
加 ”模拟 器 不 能 确定 电池 电量 水 平和 交流 充电 状态 。 
加 ”模拟 器 不 能 确定 SD 卡 的 插入 /弹出 。 
М ”模拟 器 不 支持 蓝牙 。 
2. 启动 AVD 模拟 器 的 基本 流程 
在 调试 时 需要 启动 АУР 模拟 器 ， 启 动 АУР 模拟 器 的 基本 流程 如 下 : 
(1) 选择 图 2-49 列表 中 名 为 first 的 AVD, 单 击 按钮 后 弹出 Launch Options 界面 ,如 图 2-53 
所 示 。 
(2) 单 击 Launch 按钮 后 将 会 运行 名 为 mm 的 模拟 器 ， 运 行 界面 效果 如 图 2-54 所 示 。 
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图 2-53 Launch Options 界面 图 2-54 模拟 运行 成 功 
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第 3 章 基本 数据 通信 


在 Android 物 联网 开发 应 用 中 ， 经 常 需要 网 络 、 蓝 牙 和 红外 等 设备 进行 通信 传输 ， 以 实现 不 同 设 
备 之 间 的 通信 功能 。 例 如 可 以 将 我 们 的 设备 和 远程 服务 器 相连 接 ， 获 取 和 身体 健康 相关 的 指数 等 信息 ， 
也 可 以 在 车 载 设 备 中 查看 当前 车 内 的 温度 信息 和 湿度 信息 。 本 章 将 详细 介绍 在 Android 系统 中 实现 基 
本 数据 通信 的 方法 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


3.1 HTTP 通信 


Фи 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 3 章 \HTTP 通信 .avi 

超 文 本 传输 协议 (HyperText Transfer Protocol, HTTP) 是 互联 网 上 应 用 最 为 广泛 的 一 种 网 络 协议 。 
所 有 的 WWW 文件 都 必须 遵守 这 个 标准 。 设 计 HTTP 最 初 的 目的 是 为 了 提供 一 种 发 布 和 接收 HTML 页 
面 的 方法 。HTTP 是 一 个 客户 端 和 服务 器 端 请 求 和 应 答 的 标准 CTCP)。 客 户 端 是 终端 用 户 ， 服 务 器 端 
是 网 站 。 通 过 使 用 Web 浏览 器 、 网 络 怜 虫 或 者 其 他 的 工具 ， 客 户 端 发 起 一 个 到 服务 器 上 指定 端口 〈 默 
认 端 口 为 80) 的 НТТР 请 求 。 我 们 称 这 个 客户 端 为 用 户 代理 (User Agent)。 应 答 的 服务 器 上 存储 着 (一 
些 ) 资源 ， 例 如 HTML 文件 和 图 像 。 我 们 称 这 个 应 答 服务 器 为 源 服务 器 (Origin Server)。 在 用 户 代理 
和 源 服 务 器 中 间 可 能 存在 多 个 中 间 层 ， 例 如 代理 、 网 关 ， 或 者 隧道 (Tunnels)。 尽 管 TCP/IP 协议 是 互 
联网 上 最 流行 的 应 用 ，HTTP 协议 并 没有 规定 必须 使 用 它 和 (基于) 它 支 持 的 层 。 Feb, HTTP 可 以 
在 任何 其 他 互联 网 协议 上 , 或 者 在 其 他 网 络 上 实现 。HTTP 只 假定 (其 下 层 协 议 提供 ) 可 靠 的 传输 ， 任 
何 能 够 提供 这 种 保证 的 协议 都 可 以 被 其 使 用 。 本 节 首 先 简 要 介绍 HTTP 技术 的 相关 基本 理论 知识 ， 为 
读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


3.1.1 Android 中 的 HTTP 


在 Android 系统 中 ， 为 HTTP 协议 提供 了 如 下 3 种 通信 接口 。 

标准 Java 接口 : java.net. 

M Apache 接口 : org.apache.http. 

М Android 网 络 接口 : android.net-http. 

网 络 编程 在 无 线 应 用 程序 开发 过 程 中 起 到 了 重要 的 作用 。 在 Android 系统 中 包括 Apache HttpClient 
库 ， 这 个 库 是 执行 Android 中 的 网 络 操作 的 首选 方法 。 除 此 之 外 ，Android 还 可 允许 通过 标准 的 Java 
联网 API (java.net 包 ) 来 访问 网 络 。 即 便 使 用 javanet 包 ， 也 是 在 内 部 使 用 该 Apache 库 。 

为 了 访问 互联 网 ， 需 要 设置 应 用 程序 获取 android. permission INTERNET 权限 的 许可 。 

在 Android 系统 中 ， 存 在 如 下 与 网 络 连接 相关 的 包 。 

(1) java.net 


提供 联网 相关 的 类 ， 包 括 流 和 数据 报 套 接 字 、 互 联网 协议 以 及 通用 的 HTTP 处 理 。 此 为 多 用 途 的 
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联网 资源 。 经 验 丰富 的 Java 开发 人 员 可 立即 使 用 此 惯用 的 包 来 创建 应 用 程序 。 
(2) java.io 
尽管 未 明确 联网 ， 但 其 仍然 非常 重要 。 此 包 中 的 各 种 类 通过 其 他 Java 包 中 提供 的 套 接 字 和 链接 来 
使 用 。 它 们 也 可 用 来 与 本 地 文件 进行 交互 (与 网 络 进行 交互 时 经 常 发 生 )。 
(3) java.nio 
包含 表示 具体 数据 类 型 的 缓冲 的 各 种 类 。 便 于 基于 Java 语言 的 两 个 端点 之 间 的 网 络 通信 。 
(4) org.apache.* 
表示 可 为 进行 HTTP 通信 提供 精细 控制 和 功能 的 各 种 包 。 可 将 Apache 识别 为 普通 的 开源 Web 服 
务 器 。 
(5) android.net 
包括 核心 java.net.* 类 之 外 的 各 种 附加 的 网 络 接 入 套 接 字 。 此 包 包 括 URL 类 ,其 通常 在 传统 联网 之 
外 的 Android 应 用 程序 开发 中 使 用 。 
(6) android.net.http 
包含 可 操作 SSL 证 书 的 各 种 类 。 
(7) android.net.wifi 
包含 可 管理 Android 平台 中 WiFi (802.11 无 线 以 太 网 ) 所 有 方面 的 各 种 类 。 目 前 市 场 上 大 多 数 移 
动 设备 均 配 备 有 WiFi 能 力 ， 尤 其 随 着 Android 在 对 制造 商 〈 如 诺基亚 和 LG) 的 翻盖 手机 的 研发 方面 
取得 了 进展 。 
(8) android.telephony.gsm 
包含 管理 和 发 送 短信 (文本 ) 消息 所 要 求 的 各 种 类 。 随 着 时 间 的 推移 ， 可 能 将 引入 一 种 附加 的 包 ， 
以 提供 有 关 非 GSM 网 络 〈 如 CDMA 或 类 似 android.telephony.cdma) 的 类 似 功 能 。 


3.1.2 ”使 用 Apache 接口 


因为 在 Android 平台 中 ， 使 用 得 最 多 的 是 Apache 接口 。 所 以 本 节 详 细 介绍 使 用 Apache 接口 
Corg.apache.http) 实现 网 络 连接 的 基本 知识 。 在 Apache HttpClient 库 中 ， 提 供 了 如 下 对 网 络 连接 有 用 
的 包 。 


org.apache.http.HttpResponse 

org.apache.http.client.HttpClient 

org.apache.http.client.methods.HttpGet 

org.apache.http.impl.client.DefaultHttpClient 

HttpClient httpclient-new DefaultHttpClient() 

如 果 想 从 服务 器 检索 此 信息 ， 则 需要 使 用 HttpGet 类 的 构造 器 ， 例 如 下 面 的 代码 。 

HttpGet request=new HttpGet("http://innovator.samsungmobile.com"); 

然后 用 HttpClient 类 的 execute 方法 中 的 HttpGet 对 象 来 检索 HttpResponse X Z, 例如 下 面 的 代码 。 
HttpResponse response = client.execute(request); 

接着 读 取 已 检索 的 响应 ， 例 如 下 面 的 代码 。 

BufferedReader rd = new BufferedReader 

(new InputStreamReader(response.getEntity().getContent())); 
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String line = ""; 


° 
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while ((line = rd.readLine()) != null) { 
Log.d("output: " line); 
} 
在 Android 系统 中 ， 可 以 采用 HttpPost 和 HttpGet 来 封装 post WRA get 请 求 ， 再 使 用 HttpClient 
的 excute 方法 发 送 post 或 者 get 请 求 并 返回 服务 器 的 响应 数据 .使 用 Apache 联网 的 基本 流程 如 下 所 示 。 
OD 设置 连接 和 读 取 超时 时 间 ， 并 新 建 HttpClient 对 象 ， 例 如 下 面 的 代码 。 
// 设 置 连 接 超时 时 间 和 数据 读 取 超时 时 间 
HttpParams httpParams = new BasicHttpParams(); 
HttpConnectionParams.setConnectionTimeout(httpParams, 
KeySource.CONNECTION TIMEOUT INT); 
HttpConnectionParams.setSoTimeout(httpParams, 
KeySource.SO TIMEOUT INT); 
/新建 HttpClient 对 象 
HttpClient httpClient = new DefaultHttpClient(httpParams) 
(2) 实现 Get 请 求 ， 例 如 下 面 的 代码 。 
/获取 请 求 
HttpGet get = new HttpGet(url); 
if (headers != null) 


{ 
Set<String> setHead = headers.keySet(); 
Iterator<String> iteratorHead = setHead.iterator(); 
while (iteratorHead.hasNext()) 
{ 
String headerName = iteratorHead.next(); 
String headerValue = (String) headers.get(headerName); 
MyLog.d(headerName, headerValue); 
get.setHeader(headerName, headerValue); 
} 
} 


response = httpClient.execute(get); 

(3) 实现 Post 发 送 请 求 处 理 ， 例 如 下 面 的 代码 。 
HttpPost post = new HttpPost(KeySource.HOST_URL_STR); 
Map<String, String> headers = heads; 

Set<String> setHead = headers.keySet(); 
lterator<String> iteratorHead = setHead.iterator(); 
while (iteratorHead.hasNext()) 


{ 
String headName = iteratorHead.next(); 
String headValue = (String) headers.get(headName); 
post.setHeader(headName, headValue); 

} 


pt 
* 通常 的 HTTP 实体 需要 在 执行 上 下 文 时 动态 生成 

* HttpClient 提供 使 用 EntityTemplate 实体 类 和 ContentProducer 接口 支持 动态 实体 
* 内 容 制作 是 通过 写 需 求 的 内 容 到 一 个 输出 流 ， 每 次 请 求 时 都 会 产生 

* 因此 ， 通 过 EntityTemplate 创建 实体 通常 是 独立 的 ， 重 复 性 好 

"i 

ContentProducer cp = new ContentProducer() 


{ 
e 


} 
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public void writeTo(OutputStream outstream) 


throws IOException 
{ 
Writer writer = new OutputStreamWriter(outstream,"UTF-8"); 
writer.write(requestBody); 
writer.flush(); 
writer.close(); 


} 


HttpEntity entity = new EntityTemplate(cp); 
post.setEntity(entity); 


response = httpClient.execute(post); 
(4) 通过 Response 响应 请 求 ， 例 如 下 面 的 代码 。 
if (response.getStatusLine().getStatusCode() == 200) 


pr 


* 因为 直接 调用 toString 可 能 会 导致 某 些 中 文字 符 出 现 乱码 的 情况 。 所 以 此 处 使 用 toByteArray， 
* 如 果 需 要 转 成 String 对 象 ， 可 以 先 调用 EntityUtils.toByteArray 方法 将 消息 实体 转 成 byte 数组 ， 


* 再 由 new String(byte[] bArray) 转 换 成 字符 串 
iff 
byte[] bResultXml = EntityUtils.toByteArray(response.getEntity()); 
if (bResultXml != null) 
{ 
String strXml = new String(bResultXml, "utf-8"); 
} 


} 
这 样 使 用 Apache 实现 联网 处 理 数据 交互 的 过 程 就 完成 了 , 无 论 多 么 复杂 的 项 目 ， 都 需要 遵循 上 面 


的 流程 。 


Apache 的 核心 功能 是 HttpClient， 和 网 络 有 关 的 功能 几乎 都 需要 用 HttpClient 来 实现 。 在 Android 
开发 中 经 常会 用 到 网 络 连接 功能 与 服务 器 进行 数据 的 交互 ， 为 此 Android 的 SDK 提供 了 Apache 的 
HttpClient 来 方便 我 们 使 用 各 种 Http 服务 。 可 以 把 HttpClient 想象 成 一 个 浏览 器 , 通过 它 的 АРІ 我 们 可 
以 很 方便 地 发 出 GET 请 求 和 POST 请 求 。 


例如 ， 只 需要 以 下 几 行 代码 就 能 发 出 一 个 简单 的 GET 请 求 并 打印 响应 结果 。 


try{ 


/创建 一 个 默认 的 HttpClient 

HttpClient httpclient = new DefaultHttpClient(); 

/| 创建 一 个 GET ÑR 

HttpGet request = new HttpGet("www.google.com"); 
/发 送 GET 请 求 ， 并 将 响应 内 容 转换 成 字符 串 


String response = httpclient.execute(request, new BasicResponseHandler()); 


Log.v("response text", response); 


) catch (ClientProtocolException e) ( 


e.printStackTrace(); 


} catch (IOException e) ( 


e.printStackTrace(); 


肯定 有 读者 禁不住 要 问 为 什么 上 述 代 码 要 使 用 单 例 HttpClient 呢 ? 这 只 是 一 段 演示 代码 , 实际 的 项 
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目 中 的 请 求 与 响应 处 理会 复杂 一 些 ， 并 且 还 要 考虑 到 代码 的 容错 性 ， 但 这 并 不 是 本 篇 的 重点 。 读 者 重 


点 注意 代码 的 第 3 行 : 

HttpClient httpclient = new DefaultHttpClient(); 

在 发 出 HTTP 请 求 前 先 创建 了 一 个 HttpClient 对 象 , 而 在 实际 项 目 中 , 我 们 很 可 能 在 多 处 需要 进行 
HTTP 通信 ， 这 时 不 需要 为 每 个 请 求 都 创建 一 个 新 的 HttpClient。 因 为 之 前 已 经 提 到 ，HttpClient 就 像 一 


个 小 型 的 浏 


We 


览 器 ， 对 于 整个 应 用 ， 只 需要 一 个 HttpClient 就 够 了 。 由 此 可 以 得 出 ,使 用 简单 的 单 例 就 可 


以 实现 ， 例 如 下 面 的 代码 。 
public class CustomerHttpClient { 
private static HttpClient customerHttpClient; 
private CustomerHttpClient() { 


} 


public static HttpClient getHttpClient() { 
if(null == customerHttpClient) { 


} 


customerHttpClient = new DefaultHttpClient(); 


return customerHttpClient; 


} 

但 是 如 果 同 时 有 多 个 请 求 需要 处 理 呢 ? 答案 是 使 用 多 线程 。 假 如 现在 应 用 程序 使 用 同一 个 
HttpClient 来 管理 所 有 的 Нир 请 求 ， 一 旦 出 现 并 发 请 求 ， 那么 一 定 会 出 现 多 线程 的 问题 。 这 就 好 像 我 们 
的 浏览 器 只 有 一 个 标签 页 却 有 多 个 用 户 ，A 要 上 Google, B 要 上 baidu， 这 时 浏览 器 就 会 忙 不 过 来 。 幸 
运 的 是 ，HttpClient 提供 了 创建 线程 安全 对 象 的 API， 能 够 帮助 我 们 很 快 地 得 到 线程 安全 的 “浏览 器 ”。 
例如 下 面 的 代码 很 好 地 解决 了 多 线程 问题 。 

public class CustomerHttpClient { 

private static final String CHARSET = HTTP.UTF_8; 


private static HttpClient customerHttpClient; 
private CustomerHttpClient() { 


} 


public static synchronized HttpClient getHttpClient() { 


if (null == customerHttpClient) { 


HttpParams params = new BasicHttpParams(); 
/设置 一 些 基 本 参数 
HttpProtocolParams.setVersion(params, HttpVersion.HTTP_1_1); 
HttpProtocolParams.setContentCharset(params, CHARSET); 
HttpProtocolParams.setUseExpectContinue(params, true); 
HttpProtocolParams 
.setUserAgent( 
params, 
"Mozilla/3.0(Linux;U;Android 


2.2.1;en-us;Nexus One Build.FRG83) " 


@ 


+ "AppleWebkKit/553.1(KHTML,like Gecko) Version/4.0 Mobile Safari/533.1"); 
// 超 时 设置 

让 从 连接 池 中 取 连 接 的 超时 时 间 */ 
ConnManagerParams.setTimeout(params, 1000); 

让 连接 超时 */ 
HttpConnectionParams.setConnectionTimeout(params, 2000); 
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HttpConnectionParams.setSoTimeout(params, 4000); 

/设置 HttpClient 支持 HTTP 和 HTTPS 两 种 模式 

SchemeRegistry schReg = new SchemeRegistry(); 

schReg.register(new Scheme("http", PlainSocketFactory.getSocketFactory(), 80)); 
schReg.register(new Scheme("https", SSLSocketFactory.getSocketFactory(), 443)); 

/使 用 线程 安全 的 连接 管理 来 创建 HttpClient 

ClientConnectionManager conMgr = new ThreadSafeClientConnManager(params, schReg); 
customerHttpClient = new DefaultHttpClient(conMgr, params); 


return customerHttpClient; 
} 
} 
在 上 面 的 代码 中 , 通过 getHttpClient 方法 为 HttpClient 配置 了 一 些 基 本 参数 和 超时 设置 ， 然 后 使 用 
ThreadSafeClientConnManager 来 创建 线程 安全 的 HttpClient。 


3.1.3 在 Android 中 使 用 java.net 


本 节 将 通过 具体 代码 来 演示 在 Android 中 使 用 java.net 的 基本 流程 。 
(1) 在 文件 AndroidManifestxml 中 添加 android.permission INTERNET 权限 ， 这 样 才 允许 应 用 程 
序 访问 网 络 。 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«manifest xmIns:android-"http://schemas.android.com/apk/res/android" 
package-"com.net" 
android:versionCode-"1" 
android:versionName="1.0"> 
<uses-sdk android:minSdkVersion="8" /> 
<uses-permission android:name="android.permission.INTERNET"></uses-permission> 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 
«activity android:name=".NetworkingProject" android:label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 
(2) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-" vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android:text="Enter URL" 
android:id="@+id/textView1" 
android:layout width-"wrap content" 
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android:layout_height="wrap_content"> 
</TextView> 
<EditText 
android:id="@+id/editText1" 
android:layout_width="match_parent" 
android:text="http://innovator.samsungmobile.com" 
android:layout_height="wrap_content"> 
</EditText> 
<Button 
android:text="Click Here" 
android:id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
</Button> 
<EditText 
android:id="@+id/editText2" 
android:layout_width="match_parent" 
android:layout_height="fill_parent"> 
</EditText> 
</LinearLayout> 
(3) 编写 主 程序 文件 NetworkingProjectjava， 功 能 也 是 创建 一 个 可 以 查看 网 页 HTML 代码 的 Java 
程序 。 有 具体 实现 代码 如 下 : 
package com.net; 
import java.io.BufferedReader; 
import java.io.InputStreamReader; 
import java.net.URL; 
import java.net. URLConnection; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.TextView; 
public class NetworkingProject extends Activity { 
Button bt; 
TextView textView1; 
TextView textView2; 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
bt = (Button) findViewByld(R.id.button1); 
textView1 = (TextView) findViewByld(R.id.editText1); 
textView2 = (TextView) findViewByld(R.id.editText2); 
bt.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
textView2.setText(""); 


try( 
e 


URL url = new URL(textView1.getText().toString()); 
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URLConnection conn = url.openConnection(); 
BufferedReader rd = new BufferedReader(new 
InputStreamReader(conn.getinputStream())); 
String line = "": 
while ((line = rd.readLine()) != null) ( 
textView2.append(line); 


} 
} catch (Exception exe) { 


exe. printStackTrace(); 


} 
} 
}; 
i ) 
执行 上 述 代码 后 ， 可 以 在 手机 浏览 器 中 查看 输入 网 址 网 页 的 HTML 
代码 ， 如 图 3-1 所 示 。 


3.14 使 用 Android 网 络 接口 


在 Android 平台 中 ， 我 们 可 以 使 用 Android 网 络 接口 android.nethttp 
来 处 理 HTTP 请 求 。android.net.http 是 android.net 中 的 一 个 包 , 在 里 面 主 
要 包含 处 理 SSL 证 书 的 类 。 在 android.net.http 中 存在 如 下 4 个 类 。 

AndroidHttpClient 

SslCertificate 

SslCertificate.DName 
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httg://Innovator.samsungmobile.com 


<DOCTYPE Im PUBLIC /ANSCIOTO XHTML 


"еп" lang-"en'» <head> «title»Samsung 

Имеш эз Developer 

program for Windows Mobile&#44: Jove and 
dr i= 


* type="Image/ico"/ 
‘nttp://innovator. 
layout.css" 

а" media-"all'/ 


> href 
sungmobile conv/Gs/smi content wea css" 
type="text/css" charset 8" medio="all"7 
>slink rel="stylesheet up /Annovetor 
somsungmoblle.c - 


hrefs"http;/Innovator.samsungmobile.com! 


М SslError 
: SM UT ee 
其 中 AndroidHttpClient 就 是 用 来 处 理 HTTP 请 求 的 。 
图 3-1 执行 效果 


android.net.* 实 际 上 是 通过 对 Apache 的 HttpClient 的 封装 来 实现 的 一 
个 HTTP 编程 接口 ， 同 时 还 提供 了 НТТР 请 求 队列 管理 ， 以 及 HTTP Ж 
接 池 管理 ， 以 提高 并 发 请 求情 况 下 《〈 如 转载 网 页 时 ) 的 处 理 效率 ， 除 此 之 外 还 有 网 络 状态 监视 等 接口 。 
下 面 是 一 个 通过 AndroidHttpClient 访问 服务 器 的 最 简 例 子 。 
import import android.net.http.AndroidHttpClient; 
try { 
AndroidHttpClient client  AndroidHttpClient.newInstance("your user agent"); 
/创建 HttpGet 方法 ， 该 方法 会 自动 处 理 URL 地 址 的 重 定向 
HttpGet httpGet = new HttpGet ("http://www.test_test.com/"); 
HttpResponse response = client.execute(httpGet); 
if (response.getStatusLine().getStatusCode() != HttpStatus.SC_OK) { 
// 错 误 处 理 


} 
/关闭 连接 
client.close(); 
} catch (Exception ee) { 
} 
另外 当 我 们 的 应 用 需要 同时 从 不 同 的 主机 获取 数目 不 等 的 数据 ， 并 且 仅 关心 数据 的 完整 性 而 不 关 
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心 其 先后 顺序 时 ， 也 可 以 使 用 这 部 分 的 接口 。 典 型 用 例 就 是 android.webkit 在 转载 网 页 和 下 载 网 页 资源 
时 ， 具 体 可 参考 android.webkit.* 中 的 相关 类 来 实现 。 
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实战 演练 一 一 在 屏幕 中 传递 HTTP 参数 


经 过 前 面 的 学 习 ， 了 解 到 HTTP 是 一 种 网 络 传输 协议 ， 现 实 中 的 大 多 数 网 页 都 是 通过 HTTP://WWW. 
的 形式 实现 显示 的 。 在 具体 应 用 时 ， 一 些 需 要 的 数据 都 是 通过 其 参数 传递 的 。 和 网 络 HTTP 有 关 的 是 
HTTP protocol, fE Android SDK 中 ， 集 成 了 Apache 的 HttpClient 模块 。 通 过 这 些 模块 ， 可 以 方便 地 
编写 出 和 HTTP 有 关 的 程序 。 在 Android SDK 中 通常 使 用 HttpClient 4.0。 在 下 面 的 实例 中 插入 了 两 个 


按钮 : 
加 ”一 个 按钮 用 于 以 POST 方式 获取 网 站 数据 。 
一 个 按钮 用 于 以 GET 方式 获取 数据 ， 并 以 TextView 对 象 来 显示 由 服务 器 端 返回 网 页 内 容 来 
显示 连接 结果 。 在 之 前 需要 先 建立 和 НТТР 的 连接 , 连接 之 后 才能 获取 Web Server 返回 的 结果 。 
ú 目 | H 的 | 源码 路 径 : 
E 实例 3-! ”| 在 物 联 网 设备 屏幕 中 传递 HTTP 590 1. 光 扒 \daima3\httpexample — 


(1) 编写 布局 文件 
编写 布局 文件 main.xml， 主 要 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:background="@drawable/white" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout, height-"fill parent" 
> 
<TextView 
android:id="@+id/myTextView1" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/title"/> 
<Button 
android:id="@+id/myButton1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="@string/str_button1" /> 
<Button 
android:id="@+id/myButton2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/str_button2" /> 
</LinearLayout> 
(2) 编写 程序 文件 


编写 文件 httpSHI.java， 其 具体 实现 流程 如 下 。 


加 ”引用 apache http 相关 类 实现 НТТР 联机 ， 然 后 引用 java.io 与 java.util 相关 类 来 读 写 档 案 。 具 
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体 实现 代码 如 下 : 
/引用 apache.http 相关 类 来 建立 HTTP 联机 */ 
import org.apache.http.HttpResponse; 
import org.apache.http.NameValuePair; 
import org.apache.http.client.ClientProtocolException; 
import org.apache.http.client.entity. UrlEncodedFormEntity; 
import org.apache.http.client.methods.HttpGet; 
import org.apache.http.client.methods.HttpPost; 
import org.apache.http.impl.client.DefaultHttpClient; 
import org.apache.http.message.BasicNameValuePair; 
import org.apache.http.protocol.HTTP; 
import org.apache.http.util.EntityUtils; 
/必须 引用 java.io 5 java.util 相关 类 来 读 写 档 案 */ 
import irdc.httpSHI.R; 
import java.io.IOException; 
import java.util.ArrayList; 
import java.util.List; 
import java.util.regex.Matcher; 
import java.util.regex.Pattern; 


import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 
import android.widget.TextView; 
使 用 OnClickListener 来 聆听 单 击 第 一 个 按钮 事件 ,声明 网 址 字符 串 并 使 用 建立 Post 方式 联机 ， 
最 后 通过 mTextViewl.setText 输出 提示 字符 。 有 具体 实现 代码 如 下 : 
PZE OnClickListener 来 聆听 OnClick 事件 */ 
mButton1.setOnClickListener(new Button.OnClickListener() 
{ 
Е onClick 事件 */ 
@Override 
public void onClick(View v) 
{ 
I PiBBISHIESE 4735 */ 
String uriAPI = "http://www.dubblogs.cc:8751/Android/Test/API/Post/index.php"; 
"3232 HTTP Post 联机 */ 
HttpPost httpRequest = new HttpPost(uriAPI); 
n 
* Post 运行 传送 变量 必须 用 NameValuePair[ 数 组 存储 
dl 
List <NameValuePair> params = new ArrayList <NameValuePair>(); 
params.add(new BasicNameValuePair("str", "| am Post String")); 
try 
{ 
httpRequest.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF_8)); 
/* 取 得 HTTP 输出 */ 
HttpResponse httpResponse = new DefaultHttpClient().execute(httpRequest); 
In ARS S373 200 */ 
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if(httpResponse.getStatusLine().getStatusCode() == 200) 


{ 
lRBUSCETERHR'I 
String strResult = EntityUtils.toString(httpResponse.getEntity()); 
mTextView1.setText(strResult); 
} 
else 
{ 
mTextView1.setText("Error Response: "+httpResponse.getStatusLine().toString()); 
} 
} 
catch (ClientProtocolException e) 
{ 
mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 
} 
catch (IOException e) 
{ 
mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 
} 
catch (Exception e) 
{ 
mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 


} 
} 


使 用 OnClickListener 来 聆听 单 击 第 二 个 按钮 的 事件 ， 声 明 网 址 字符 串 并 建立 Get 方式 的 联机 


功能 ， 分 别 实现 发 出 HTTP 获取 请 求 、 获 取 应 答 字符 串 和 删除 元 余 字 符 操 作 ， 最 后 通过 
mTextViewl.setText 输出 提示 字符 。 有 具体 实现 代码 如 下 : 
mButton2.setOnClickListener(new Button.OnClickListener() 
{ 
@Override 
public void onClick(View v) 
{ 
I FRAPS FFE) 
String uriAPI = "http://www.XXXX.cc:8751/index.php?str=I+am+Get+String"; 
[Уг HTTP Get 联机 */ 
HttpGet httpRequest = new HttpGet(uriAPI); 
try 
{ 
/发 出 HTTP 获取 请 求 */ 
HttpResponse httpResponse = new DefaultHttpClient().execute(httpRequest); 
A/* 若 状态 码 为 200 ok*/ 
if(httpResponse.getStatusLine().getStatusCode() == 200) 
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String strResult = EntityUtils.toString(httpResponse.getEntity()); 
让 删除 元 余 字符 */ 
strResult = eregi_replace("(\r\n|\r|\n|\n\r)","",strResult); 
mTextView1.setText(strResult); 

} 


else 


{ 
mTextView1.setText("Error Response: "+httpResponse.getStatusLine().toString()); 


} 

} 

catch (ClientProtocolException e) 

{ 
mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 


} 
catch (IOException e) 


mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 


) 


catch (Exception e) 


mTextView1.setText(e.getMessage().toString()); 
e.printStackTrace(); 


定义 替换 字符 串 函 数 eregi replace 来 蔡 换 一 些 非 法 字符 ， 具 体 实 现代 码 如 下 : 
PHB ERA 
public String eregi_replace(String strFrom, String strTo, String strTarget) 
{ 
String strPattern = "(?i)"+strFrom; 
Pattern p = Pattern.compile(strPattern); 
Matcher m = p.matcher(strTarget); 
if(m.find()) 
{ 
return strTarget.replaceAll(strFrom, strTo); 
} 
else 
{ 
return strTarget; 
} 
3 
) 
(3) 声明 网 络 连接 权限 


在 文件 AndroidManifest.xml 中 声明 网 络 连接 权限 ， 有 具体 实现 代码 如 下 : 


<uses-permission android:name="android.permission.INTERNET"></uses-permission> 


执行 后 的 效果 如 图 3-2 所 示 ， 单 击 图 中 的 按钮 能 够 以 不 同方 式 获取 НТТР 参数 。 
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使用 POST 方式 


使 用 GET 方 式 


3-2 单 击 “ 使 用 POST 方式 ”按钮 后 的 效果 
3.1.6 ”实战 演练 一 一 在 户外 运动 过 程 中 访问 HTTP 地 图 


在 使 用 智能 物 联网 设备 的 过 程 中 ， 经 常 需要 远程 服务 器 的 信息 。 例 如 作为 一 名 户外 驴友 成 员 ， 为 
了 确保 自己 行走 的 路 程 准确 无 误 ， 可 以 随时 访问 服务 器 中 的 地 图 来 进行 对 照 。 在 下 面 的 实例 中 ， 以 一 
名 户外 驴友 使 用 物 联网 设备 为 背景 ， 讲 解 了 在 Android 物 联网 设备 中 使 用 HTTP 访问 服务 器 中 地 图 的 
过 程 。 

在 下 面 的 实例 中 首先 创建 了 HttpGet 和 HttpPost 对 象 ， 并 将 要 请 求 的 URL 对 象 构造 方法 传 入 
HttpGet、HttpPost 对 象 中 。 然 后 通过 HttpClient 接 口 的 实现 类 DefaultClent 的 excute(HttpUriRequest request) 
方法 实现 连接 处 理 。 因 为 已 经 知道 HttpGet 和 HttpPost 类 都 实现 了 HttpUriRequest 接口 ， 所 以 可 以 将 前 
面 创 建 好 的 HttpGet 或 者 HttpPost 对 象 传 入 以 得 到 HttpResponse 对 象 。 最 后 通过 HttpResponse 获取 返 
回 的 HTTP 资源 信息 ， 然 后 再 做 提取 工作 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
CD 编写 布局 文件 main.xml， 在 界面 中 分 别 插入 3 个 Button 按钮 和 两 个 EditText 控件 ， 主 要 代码 
如 下 : 


<LinearLayout android:orientation="horizontal" 
android:layout width-"fill parent" android:layout_height="wrap_content"> 
<TextView android:layout width-"wrap content" 
android:layout height-"wrap content" android:text="url:" /> 
«EditText android:id="@+id/urlText" android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"" /> 
</LinearLayout> 
<LinearLayout android:orientation-"horizontal" 
android:layout_width="fill_parent" android:layout height-"wrap content" 
android:gravity="right"> 
«Button android:id="@+id/getBtn" android:text="GET 请 求 " 
android:layout width-"wrap content" android:layout height-"wrap content" /> 
«Button android:id="@+id/postBtn" android:text="POST їй" 
android:layout width-"wrap content" android:layout height-"wrap content" /> 
</LinearLayout> 
<TextView android:id="@+id/resultView" android:layout_width="fill_parent" 
android:layout height-"wrap content" /> 
<LinearLayout android:orientation-"horizontal" 
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android:layout_width="fill_parent" android:layout_height="wrap_content"> 
<TextView android:layout_width="wrap_content" 
android:layout height-"wrap content" android:text="H url:" /> 


<EditText android:id="@+id/imageurlText" android:layout width-"fill parent" 
android:layout height-"wrap content" android:text-"" /> 
</LinearLayout> 
«Button android:id="@+id/imgBtn" android:text=" 获 取 图 片 " 
android:layout_width="wrap_content" android:layout height-"wrap content" 
android:layout gravity-"right" /> 
<ImageView android:id="@+id/imgeView01" 
android:layout_height="wrap_content" android:layout_width="fill_parent" /> 
</LinearLayout> 
(2) 编写 核心 文件 НТТРрешоАсіуйујауа, Ж EditText 控件 中 输入 的 数据 来 访问 远程 HTTP 
资源 , 并 将 得 到 的 信息 转换 成 为 一 个 输出 流 并 返回 。 在 整个 实现 过 程 中 需要 通过 url 创建 HttpGet WR, 
并 通过 DefaultClient 的 execute 方法 返回 一 个 HttpResponse 对 象 。 文 件 HTTPDemoActivityjava 的 主要 
实现 代码 如 下 : 
private String request(String method, String url) { 
HttpResponse httpResponse = null; 
StringBuffer result = new StringBuffer(); 
try { 
if (method.equals("GET")) { 
/1/1. 通 过 url 创建 HttpGet 对 象 
HttpGet httpGet = new HttpGet(url); 
/2. 通 过 DefaultClient 的 execute 方法 执行 返回 一 个 HttpResponse 对 象 
HttpClient httpClient = new DefaultHttpClient(); 
httpResponse = httpClient.execute(httpGet); 
/3. 取 得 相关 信息 
// 取 得 HttpEntiy 
HttpEntity httpEntity = httpResponse.getEntity(); 
// 得 到 一 些 数据 
// 通 过 EntityUtils 并 指定 编码 方式 取 到 返回 的 数据 
result.append(EntityUtils.toString(httpEntity, "utf-8")); 
/得 到 StatusLine 接口 对 象 
StatusLine statusLine = httpResponse.getStatusLine(); 


/得 到 协议 


result.append(" 协 议 :" + statusLine.getProtocolVersion() + "\r\n"); 
int statusCode = statusLine.getStatusCode(); 


resultappend(" 状 态 码 :" + statusCode + "\rin"); 
} else if (method.equals("POST")) { 
//1. 通 过 url 创建 HttpGet 对 象 


HttpPost httpPost = new HttpPost(url); 
//2. 通 过 DefaultClient 的 execute 方法 执行 返回 一 个 HttpResponse WR 
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HttpClient httpClient = new DefaultHttpClient(); 
httpResponse = httpClient.execute(httpPost); 

/13. 取 得 相关 信息 

/取得 HttpEntiy 

HttpEntity httpEntity = httpResponse.getEntity(); 
/得 到 一 些 数据 

/通过 EntityUtils 并 指定 编码 方式 取 到 返回 的 数据 
result.append(EntityUtils.toString(httpEntity, "utf-8")); 
StatusLine statusLine = httpResponse.getStatusLine(); 
statusLine.getProtocolVersion(); 

int statusCode = statusLine.getStatusCode(); 


result.append(" 状 态 码 :" + statusCode + "\r\n"); 


} 
} catch (Exception e) { 

Toast.makeText(HTTPDemoActivity.this, "网 络 连 接 异常 , Toast.LENGTH_LONG).show(); 
} 
return result.toString(); 


} 


public void getlmage(String url) { 
try { 

ПА 3833: url 创建 HttpGet 对 象 
HttpGet httpGet = new HttpGet(url); 
//2. 通 过 DefaultClient 的 execute 方法 执行 返回 一 个 HttpResponse 对 象 
HttpClient httpClient = new DefaultHttpClient(); 
HttpResponse httpResponse = httpClient.execute(httpGet); 
/3. 取 得 相关 信息 
// 取 得 HttpEntiy 
HttpEntity httpEntity = httpResponse.getEntity(); 
//4. 通 过 HttpEntiy.getContent 得 到 一 个 输入 流 
InputStream inputStream = httpEntity.getContent(); 
System.out.printin(inputStream.available()); 


// 通 过 传 入 的 流 再 通过 Bitmap 工厂 创建 一 个 Bitmap 

Bitmap bitmap = BitmapFactory.decodeStream(inputStream); 
/设置 imageView 

imageView.setlmageBitmap(bitmap); 


} catch (Exception e) { 
Toast.makeText(HTTPDemoActivity.this, "网 络 连接 异常 " Toast.LENGTH_LONG) 
.Show(); 

} 


} 
(3) 在 设置 文件 AndroidManifest.xml 中 添加 访问 网 络 资源 的 权限 ， 有 具体 实现 代码 如 下 所 示 。 
<uses-permission android:name="android.permission.INTERNET"/> 
(4) 设置 一 个 Java 服务 器 环境 ， 在 里 面 添加 服务 器 资源 供 前 面 的 Android 客户 端 来 访问 。 将 光盘 
中 源码 的 Servers 部 分 复制 到 本 地 Java 服务 器 的 Tomcat 中 。 最 终 客 户 端 在 模拟 器 中 的 执行 效果 如 图 3-3 
所 示 。 
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http://10.0.2.2:8080/NetServeT 
queryServlet?bookld=2 
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3-3 ”获取 服务 器 中 的 地 图 


3.2 ”使 用 Socket 实现 数据 通信 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 3 章 \ 使 用 Socket 实现 数据 通信 ,avi 

在 物 联 网 设备 的 数据 传输 应 用 中 , 通常 可 以 通过 ТСР. IP BK UDP 这 з 种 协议 实现 数据 传输 。 在 传 
输 数据 的 过 程 中 ， 需 要 通过 一 个 双向 的 通信 连接 实现 数据 的 交互 。 在 这 个 传输 过 程 中 ， 通 常 将 这 个 双 
向 链 路 的 一 端 称 为 Socket， 一 个 Socket 通常 由 一 个 IP 地 址 和 一 个 端口 号 来 确定 。 由 此 可 见 ， 在 整个 数 
据 传输 过 程 中 , Socket 的 作用 是 巨大 的 。 在 Java 编程 应 用 中 , Socket 是 Java 网 络 编程 的 核心 。 因为 Java 
是 Andord 应 用 开发 的 主流 语言 , 所 以 本 节 将 详细 讲解 在 Android 系统 中 使 用 Socket 实现 通信 的 基本 知 
识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


3.2.1 基于 Socket 的 Java 网 络 编程 


网 络 上 的 两 个 程序 通过 一 个 双向 的 通信 连接 实现 数据 的 交换 ， 这 个 双向 链 路 的 一 端 称 为 一 个 
Socket. Socket 通常 用 来 实现 客户 方 和 服务 方 的 连接 。Socket 是 TCP/IP 协议 的 一 个 十 分 流行 的 编程 界 
Hi, 一 个 Socket 由 一 个 了 P 地 址 和 一 个 端口 号 唯一 确定 。 (ALE, Socket 所 支持 的 协议 种 类 也 不 只 TCP/IP 
一 种 ， 因 此 两 者 之 间 是 没有 必然 联系 的 。 在 Java 环境 下 ，Socket 编程 主要 是 指 基于 TCP/IP 协议 的 网 络 
编程 。 


1. Socket 通信 的 过 程 


Server 端 Listen CHI) 某 个 端口 是 否 有 连接 请 求 ，Client 端 向 Server 端 发 出 Connect (连接 ) 请 
OR, Server 端 向 Client 端 发 回 Accept (接受 ) 消息 。 这 样 一 个 连接 就 建立 起 来 了 。Server MM Client 
端 都 可 以 通过 Send. Write 等 方法 与 对 方 通信 。 
在 Java 网 络 编程 应 用 中 , 对 于 一 个 功能 齐全 的 Socket 来 说 , 其 工作 过 程 包含 如 下 所 示 的 基本 步骤 。 
(1) 创建 Socket。 
(2) 打开 连接 到 Socket 的 输入 /输出 流 。 
(3) 按照 一 定 的 协议 对 Socket 进行 读 / 写 操作 。 
(4) 关闭 Socket。( 在 实际 应 用 中 ， 并 未 使 用 到 显示 的 close， 虽 然 很 多 文章 都 推荐 如 此 ， 不 过 在 


Был 


笔者 的 程序 中 ， 可 能 因为 程序 本 身 比 较 简单 ， 要 求 不 高 ， 所 以 并 未 造成 什么 影响 。) 
2. 创建 Socket 


在 Java 网 络 编程 应 用 中 ， 在 包 java.net 中 提供 了 Socket 和 ServerSocket 两 个 类 ， 分 别 用 来 表示 双 
向 连接 的 客户 端 和 服务 端 。 这 是 两 个 封装 得 非常 好 的 类 ， 其 中 包含 了 如 下 所 示 的 构造 方法 。 
Socket(InetAddress address, int port) 
Socket(InetAddress address, int port, boolean stream) 
Socket(String host, int prot) 
Socket(String host, int prot, boolean stream) 
Socket(SocketImpl impl) 
Socket(String host, int port, InetAddress localAddr, int localPort) 
Socket(InetAddress address, int port, InetAddress localAddr, int localPort) 
ServerSocket(int port) 
ServerSocket(int port, int backlog) 
ServerSocket(int port, int backlog, InetAddress bindAddr) 
在 上 述 构造 方法 中 ， 参 数 address、host 和 port SA AWM [ЖЕЕ RA — A C] TP 地 址 、 主 机 名 和 端口 
号 ，stream 指明 socket 是 流 socket 还 是 数据 报 socket, localPort 表示 本 地 主机 的 端口 号 ，localAddr 和 
bindAddr 是 本 地 机 器 的 地 址 (ServerSocket 的 主机 地 址 )，impl 是 socket 的 父 类 ， 既 可 以 用 来 创建 
seIVerSocket， 又 可 以 用 来 创建 Socket, count 则 表示 服务 端 所 能 支持 的 最 大 连接 数 。 例 如 : 
Socket client = new Socket("123.0.01.", 80); 
ServerSocket server = new ServerSocket(80); 
注意 : 每 一 个 端口 提供 一 种 特定 的 服务 ， 只 有 给 出 正确 的 端口 ,才能 获得 相应 的 服务 。0 一 1023 的 端口 
号 为 系统 所 保留 ， 例 如 http 服务 的 端口 号 为 80，telnet 服务 的 端口 号 为 21，ftp 服务 的 端口 号 为 
23， 所 以 在 选择 端口 号 时 ， 最 好 选择 一 个 大 于 1023 的 数 以 防止 发 生 冲 突 。 另 外 ， 在 创建 Socket 
时 如 果 发 生 错误 ， 将 产生 IOException， 在 程序 中 必须 对 之 作出 处 理 。 所 以 在 创建 Socket 或 
ServerSocket 时 必须 捕获 或 抛 出 例外 。 


3.22 ”使 用 TCP 协议 传输 数据 


ТСРЛР 通信 协议 是 一 种 可 靠 的 网 络 协议 ， 能 够 在 通信 的 两 端 各 建立 一 个 Socket， 从 而 在 通信 的 两 
端 之 间 形 成 网 络 虚拟 链 路 。 一 旦 建立 了 虚拟 的 网 络 链 路 ， 两 端的 程序 就 可 以 通过 虚拟 链 路 进行 通信 。 
Java 语言 对 TCP 网 络 通信 提 供 了 良好 的 封装 ， 通 过 Socket 对 象 代表 两 端的 通信 端口 ， 并 通过 Socket 
产生 的 VO 流 进行 网 络 通信 。 

(1) 使 用 ServerSocket 

在 Java 程序 中 ， 使 用 类 ServerSocket 接受 其 他 通信 实体 的 连接 请 求 。 对 象 ServerSocket 的 功能 是 
监听 来 自 客户 端的 Socket 连接 ， 如 果 没 有 连接 则 会 一 直 处 于 等 待 状态 。 在 类 ServerSocket 中 包含 了 如 
下 监听 客户 端 连 接 请 求 的 方法 。 

Socket accept(): 如 果 接 收 到 一 个 客户 端 Socket 的 连接 请 求 ， 该 方法 将 返回 一 个 与 客户 端 Socket 
对 应 的 Socket， 否 则 该 方法 将 一 直 处 于 等 待 状态 ， 线 程 也 被 阻塞 。 
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为 了 创建 ServerSocket Я] @, ServerSocket 类 提供 了 如 下 构造 器 。 
М ServerSocket(int port): 用 指定 的 端口 port 创建 一 个 ServerSocket， 该 端口 应 该 有 一 个 有 效 的 端 
口 整数 值 0 一 65535 。 
М ServerSocket(int portint backlog): 增加 一 个 用 来 改变 连接 队列 长 度 的 参数 backlog。 
М ServerSocket(int port,int backlog,InetAddress localAddr): 在 机 器 存在 多 个 IP 地 址 的 情况 下 ,人 允 
许 通 过 localAddr 这 个 参数 来 指定 将 ServerSocket 绑 定 到 指定 的 卫 地 址 。 
当 使 用 ServerSocket 后 ， 需 要 使 用 ServerSocket 中 的 方法 close0 关 闭 该 ServerSocket。 在 通常 情况 
下 ， 因 为 服务 器 不 会 只 接收 一 个 客户 端 请 求 ， 而 是 会 不 断 地 接收 来 自 客户 端的 所 有 请 求 ， 所 以 可 以 通 
过 循环 来 不 断 地 调用 ServerSocket 中 的 方法 accept0。 例 如 下 面 的 代码 。 
// 创 建 一 个 ServerSocket， 用 于 监听 客户 端 Socket 的 连接 请 求 
ServerSocket ss = new ServerSocket(30000); 


/采用 循环 不 断 接收 来 自 客户 端的 请 求 
while (true) 


{ 

// 每 当 接 收 到 客户 端 Socket 的 请 求 ， 服 务 器 端 也 对 应 产生 一 个 Socket 
Socket s = ss.accept(); 

/下 面 就 可 以 使 用 Socket 进行 通信 了 


} 

在 上 述 代码 中 ， 创 建 的 ServerSocket 没有 指定 IP 地址， 该 ServerSocket 会 绑 定 到 本 机 默认 的 IP 地 
址 。 在 代码 中 使 用 30000 作为 该 ServerSocket 的 端口 号 ， 通 常 推荐 使 用 10000 以 上 的 端口 ， 主 要 是 为 
了 避免 与 其 他 应 用 程序 的 通用 端口 冲突 。 

(2) 使 用 Socket 

在 客户 端 可 以 使 用 Socket 的 构造 器 实现 和 指定 服务 器 的 连接 ， 在 Socket 中 可 以 使 用 如 下 两 个 构 
造 器 。 

Socket(InetAddress/String remoteAddress,int port): 创建 连接 到 指定 远程 主机 、 远 程 端口 的 
Socket， 该 构造 器 没有 指定 本 地 地 址 、 本 地 端口 ， 默 认 使 用 本 地 主机 的 默认 IP 地 址 ， 默 认 使 
用 系统 动态 指定 的 他 地 址 。 

Socket(InetAddress/String remoteAddress, int port, InetAddress localAddr, int localPort): 创建 连接 
到 指定 远程 主机 、 远 程 端 口 的 Socket， 并 指定 本 地 IP 地 址 和 本 地 端口 号 ， 适 用 于 本 地 主机 有 
£" IP 地 址 的 情形 。 

在 使 用 上 述 构造 器 指定 远程 主机 时 ， 既 可 使 用 InetAddress 来 指定 ， 也 可 以 使 用 String 对 象 指定 ， 
在 Java 中 通常 使 用 String 对 象 指定 远程 P， 例 如 192.163.2.23。 当 本 地 主机 只 有 一 个 IP 地 址 时 ， 建 议 


使 用 第 一 个 方法 ， 因 为 这 样 更 简单 。 例 如 下 面 的 代码 。 
// 创 建 连接 到 本 机 、30000 端口 的 Socket 
Socket s = new Socket("123.0.0.1" , 30000); 


当 程序 执行 上 述 代码 后 会 连接 到 指定 服务 器 , 让 服务 器 端的 ServerSocket 的 方法 accept0 向 下 执行 ， 
于 是 服务 器 端 和 客户 端 就 产生 一 对 互相 连接 的 Socket。 上 述 代码 连接 到 “远程 主机 ”的 IP 地 址 是 
123.0.0.1, JE IP 地 址 总 是 代表 本 级 的 IP 地 址 。 因 为 笔者 示例 程序 的 服务 器 端 、 客 户 端 都 是 在 本 机 运行 ， 
所 以 Socket 连接 到 远程 主机 的 IP 地 址 使 用 123.0.0.1。 
当 客 户 端 、 服 务 器 端 产 生 对 应 的 Socket 之 后 ， 程 序 无 须 再 区 分 服务 器 端 和 客户 端 ， 而 是 通过 各 自 
的 Socket 进行 通信 。 在 Socket 中 提供 如 下 两 个 方法 获取 输入 流 和 输出 流 。 
® 
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InputStream getInputStream(): 返回 该 Socket 对 象 对 应 的 输入 流 , 让 程序 通过 该 输入 流 从 Socket 
中 取出 数据 。 
OutputStream getOutputStream(): 返回 该 Socket 对 象 对 应 的 输出 流 ， 让 程序 通过 该 输出 流向 
Socket 中 输出 数据 。 
(3) TCP 中 的 多 线程 
在 实际 应 用 中 ， 通 过 ServerSocket 通常 只 能 实现 Server 和 Client 之 间 的 简单 通信 操作 ， 当 服务 器 
接收 到 客户 端 连接 之 后 ， 服 务 器 向 客户 端 输出 一 个 字符 串 ， 而 客户 端 也 只 是 读 取 服 务 器 的 字符 串 后 就 
退出 了 。 在 实际 应 用 中 ， 客 户 端 可 能 需要 和 服务 器 端 保持 长 时 间 通 信 ， 即 服务 器 需要 不 断 地 读 取 客 户 
端 数据 ， 并 向 客户 端 写 入 数据 ， 客 户 端 也 需要 不 断 地 读 取 服 务 器 数据 ， 并 向 服务 器 写 入 数据 。 
当 使 用 readLine() 方 法 读 取 数 据 时 , 如 果 在 该 方法 成 功 返 回 之 前 线程 被 阻塞 , 则 程序 无 法 继续 执行 。 
所 以 此 服务 器 很 有 必要 为 每 个 Socket 单独 启动 一 条 线程 , 每 条 线程 负责 与 一 个 客户 端 进行 通信 。 另外， 
因为 客户 端 读 取 服 务 器 数据 的 线程 同样 会 被 阻塞 ， 所 以 系统 应 该 单独 启动 一 条 线程 ， 该 线程 专门 负责 
读 取 服 务 器 数据 。 
假设 要 开发 一 个 聊天 室 程 序 ， 在 服务 器 端 应 该 包含 多 条 线程 ， 其 中 每 个 Socket 对 应 一 条 线程 ， 该 
线程 负责 读 取 Socket 对 应 输入 流 的 数据 (从 客户 端 发 送 过 来 的 数据 )， 并 将 读 到 的 数据 向 每 个 Socket 
输出 流 发 送 一 遍 〈 将 一 个 客户 端 发 送 的 数据 “广播 ”给 其 他 客户 端 )， 因 此 需要 在 服务 器 端 使 用 List 
来 保存 所 有 的 Socket。 在 具体 实现 时 ， 为 服务 器 提供 了 如 下 两 个 类 。 
创建 ServerSocket 监听 的 主 类 。 
处 理 每 个 Socket 通信 的 线程 类 。 
(4) 实现 非 阻 塞 Socket 通信 
在 Java 应 用 程序 中 ， 可 以 使 用 NIO API 来 开发 高 性 能 网 络 服务 器 。 当 程序 执行 输入 /输出 操作 后 ， 
在 这 些 操 作 返 回 之 前 会 一 直 阻塞 该 线程 ， 服 务 器 必须 为 每 个 客户 端 都 提供 一 条 独立 线程 进行 处 理 。 这 
说 明 前 面 的 程序 是 基于 阻塞 式 API 的 ， 当 服务 器 需要 同时 处 理 大 量 客户 端 时 ， 这 种 做 法 会 降低 性 能 。 
在 Java 应 用 程序 中 可 以 用 NIO АРІ 让 服务 器 使 用 一 个 或 有 限 几 个 线程 来 同时 处 理 连接 到 服务 器 上 
的 所 有 客户 端 。 在 Java 的 NIO 中 ， 为 非 阻塞 式 的 Socket 通信 提供 了 下 面 的 特殊 类 。 
Selector: 是 SelectableChannel 对 象 的 多 路 复 用 器 ， 所 有 希望 采用 非 阻塞 方式 进行 通信 的 
Channel 都 应 该 注册 到 Selector 对 象 .可 通过 调用 此 类 的 静态 open() 方 法 来 创建 Selector 实例 ， 
该 方法 将 使 用 系统 默认 的 Selector 来 返回 新 的 Selector. Selector 可 以 同时 监控 多 个 
SelectableChannel [f] 1/0 状况 ,是 非 阻塞 VO 的 核心 ,一 个 Selector 实例 有 如 下 3 个 SelectionKey 
的 集合 。 
> 所 有 SelectionKey EA: 代表 了 注册 在 该 Selector 上 的 Channel, 这 个 集合 可 以 通过 keys() 
方法 返回 。 
> ”被 选择 的 SelectionKey 集合 : 代表 了 所 有 可 通过 select0 方 法 监测 到 、 需 要 进行 IO 处 理 
的 Channel， 这 个 集合 可 以 通过 selectedKeys()i& |]. 
> 被 取消 的 SelectionKey 集 合 :代表 了 所 有 被 取消 注册 关系 的 Channel, 在 下 一 次 执行 selectO 
方法 时 , 这 些 Channel 对 应 的 SelectionKey 会 被 彻底 删除 , 程序 通常 无 须 直 接 访问 该 集合 。 
除 此 之 外 ，Selector 还 提供 了 如 下 和 selectO 相 关 的 方法 。 
> int select0: 监控 所 有 注册 的 Channel, 当 它们 中 间 有 需要 处 理 的 VO 操作 时 , 该 方法 返回 ， 
并 将 对 应 的 SelectionKey 加 入 被 选择 的 SelectionKey 集合 中 ， 该 方法 返回 这 些 Channel 
e. 
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的 数量 。 
>  intselect(long timeout): 可 以 设置 超时 时 长 的 selectO 操 作 。 
> int selectNow0: 执行 一 个 立即 返回 的 select0 操 作 ， 相 对 于 无 参数 的 select0 方 法 而 言 ， 该 
方法 不 会 阻塞 线程 。 
> Selector wakeup): 使 一 个 还 未 返回 的 select0 方 法 立刻 返回 。 
SelectableChannel: 它 代表 可 以 支持 非 阻塞 VO 操作 的 Channel 对 象 , 可 以 将 其 注册 到 Selector 
上 ， 这 种 注册 的 关系 由 SelectionKey 实例 表示 。 在 Selector 对 象 中 ， 可 以 使 用 select0 方 法 设 
置 允 许 应 用 程序 同时 监控 多 个 VO Channel. Java 程序 可 调用 SelectableChannel 中 的 register() 
方法 将 其 注册 到 指定 Selector 上 ， 当 该 Selector 上 某 些 SelectableChannel 上 有 需要 处 理 的 VO 
操作 时 ， 程 序 可 以 调用 Selector 实例 的 select0 方 法 获取 它们 的 数量 ， 并 通过 selectedKeys() 方 
法 返回 它们 对 应 的 SelectKey 集合 。 这 个 集合 的 作用 巨大 ， 因 为 通过 该 集合 就 可 以 获取 所 有 需 
要 处 理 VO 操作 的 SelectableChannel 集 。 
对 象 SelectableChannel 支持 阻塞 和 非 阻 塞 两 种 模式 ， 其 中 所 有 channel 默认 都 是 阻塞 模式 , 我 们 必 
须 使 用 非 阻 塞 式 模式 才 可 以 利用 非 阻塞 IO 操作 。 
在 SelectableChannel 中 提供 了 如 下 两 个 方法 来 设置 和 返回 该 Channel 的 模式 状态 。 
回 SelectableChannel configureBlocking(boolean block): 设置 是 否 采 用 阻塞 模式 。 
M boolean isBlocking(): 返回 该 Channel 是 否 是 阻塞 模式 。 
不 同 的 SelectableChannel 所 支持 的 操作 不 一 样 ， 例 如 ServerSocketChannel 代表 一 个 ServerSocket， 
它 就 只 支持 OP_ACCEPT 操作 。 在 SelectableChannel 中 提供 了 如 下 方法 来 返回 它 支持 的 所 有 操作 。 
int validOps0: 返回 一 个 bit mask， 表 示 这 个 channel 上 支持 的 IO 操作 。 
除 此 之 外 ，SelectableChannel 还 提供 了 如 下 方法 获取 它 的 注册 状态 。 
> boolean isRegistered(): 返回 该 Channel 是 否 已 注册 在 一 个 或 多 个 Selector 上 。 
>  SelectionKey keyFor(Selector sel): 返回 该 Channel 和 sel Selector 之 间 的 注册 关系 ,如果 不 
存在 注册 关系 ， 则 返回 null. 
>  SelectionKey: 该 对 象 代表 SelectableChannel 和 Selector 之 间 的 注册 关系 。 
>  ServerSocketChannel: 支持 非 阻塞 操作 , 对 应 于 java.net.ServerSocket 这 个 类 , 提供 了 TCP 
协议 VO 接口 ， 只 支持 ОР АССЕРТ 操作 。 该 类 也 提供 了 accept0 方 法 ， 功 能 相当 于 
ServerSocket 提供 的 accept0 方 法 。 
>  SocketChannel: 支持 非 阻塞 操作 ， 对 应 于 java.net.Socket 这 个 类 ， 提 供 了 TCP 协议 VO 
接口 ,支持 OP CONNECT, OP READ #1 ОР WRITE 操作 。 这 个 类 还 实现 了 ByteChannel 
接口 、ScatteringByteChannel 接口 和 GatheringByteChannel 接口 ， 所 以 可 以 直接 通过 
SocketChannel 来 读 写 ByteBuffer 对 象 。 
服务 器 上 所 有 Channel 都 需要 向 Selector 注册 ， 包 括 ServerSocketChannel 和 SocketChannel. iZ 
Selector 则 负责 监视 这 些 Socket 的 IO 状态 ， 当 其 中 任意 一 个 或 多 个 Channel 具有 可 用 的 IO 操作 时 ， 
iY Selector 的 select0 方 法 将 会 返回 大 于 0 的 整数 , 该 整数 值 就 表示 该 Selector 上 有 多 少 个 Channel 具有 
可 用 的 VO 操作 , 并 提供 了 selectedKeys0 方 法 来 返回 这 些 Channel 对 应 的 SelectionKey 集合 。 正 是 通过 
Selector 才 使 得 服务 器 端 只 需要 不 断 地 调用 Selector 实例 的 select0 方 法 ， 就 可 以 知道 当前 所 有 Channel 
是 否 有 需要 处 理 的 VO 操作 。 当 Selector 上 注册 的 所 有 Channel 都 没有 需要 处 理 的 VO 操作 时 ， 将 会 阻 
塞 select0 方 法 ， 此 时 调用 该 方法 的 线程 被 阻塞 。 
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我 们 继续 以 聊天 室 为 例 ， 讲 解 非 阻塞 Socket 通信 在 Java 应 用 项 目 中 的 实现 过 程 。 我 们 的 目标 是 ， 
在 服务 器 端 使 用 循环 不 断 获取 Selector 的 select0 方 法 返回 值 ， 当 该 返回 值 大 于 0 时 就 处 理 该 Selector 上 
被 选择 SelectionKey 所 对 应 的 Channel. 在 具体 实现 时 , 服务 器 端 使 用 ServerSocketChannel 来 监听 客户 端 
的 连接 请 求 ， 程 序 先 调用 它 的 socket0 方 法 获得 关联 ServerSocket 对 象 ， 再 用 该 ServerSocket 对 象 绑 定 到 
指定 监听 IP 和 端口 。 最 后 在 服务 器 端 调用 Selector 的 select(0 方 法 来 监听 所 有 Channel 上 的 UO 操作 。 


3.3 下 载 数 据 


GE 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 3 章 \ 下 载 数据 .avi 

下 载 是 指 通 过 网 络 进 行文 件 传 输 ， 把 互联 网 或 其 他 电子 计算 机 上 的 信息 保存 到 本 地 电脑 上 的 一 种 
网 络 活动 。 下 载 可 以 显 式 或 隐 式 地 进行 ， 只 要 是 获得 本 地 电脑 上 所 没有 的 信息 的 活动 ， 都 可 以 认为 是 
下 载 ， 如 在 线 观看 。 在 Android 物 联网 开发 过 程 中 ， 下 载 功 能 是 十 分 常见 的 一 个 应 用 。 本 节 将 详细 讲 
解 在 Android 物 联 网 中 实现 远程 下 载 数据 的 基本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 
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实例 文件 GetAPictureFromInternetActivity.java 的 主要 实现 代码 如 下 : 
public class GetAPictureFrominternetActivity extends Activity { 

private EditText pathText; 

private ImageView imageView; 


@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
pathText = (EditText) this.findViewByld(R.id.path); 
imageView = (ImageView) this.findViewByld(R.id.imageView); 

} 


public void showimage(View v){ 
String path = pathText.getText().toString(); 
try { 
Bitmap bitmap = ImageService.getlmage(path); 
imageView.setlmageBitmap(bitmap); 
} catch (Exception e) { 
e.printStackTrace(); 
Toast.makeText(getApplicationContext(), R.string.error, 1).show(); 
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执行 后 的 效果 如 图 3-4 所 示 。 


http.//img10.360buyimg.com/book1/s75x75_g14/ 
MOA/06/09/ 

fBEhWHpYGsIAAAAAABAHIBqO9gAABOSAOXBXEAAHg2 
335 


图 3-4 执行 效果 
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JSON 是 JavaScript Object Notation 的 缩写 , 是 一 种 轻 量 级 的 数据 交换 格式 。 ISON 是 基于 JavaScript 
(Standard ECMA-262 3rd Edition-December 1999) 的 一 个 子 集 ， 采 用 完全 独立 于 语言 的 文本 格式 ， 但 
是 也 使 用 了 类 似 于 C 语言 家 族 的 习惯 (包括 C. C++. CH. Java. JavaScript. Perl, Python 等 )。 这 些 
特性 使 ISON 成 为 理想 的 数据 交换 语言 ， 易 于 阅读 和 编写 ， 同 时 也 易于 机 器 解析 和 生成 。 
下 面 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲 解 在 Android 物 联网 设备 中 远程 下 载 服务 器 中 的 
JSON 数据 的 方法 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 使 用 Eclipse 新 建 一 个 JavaEE 工程 作为 服务 器 端 ， 设 置 工程 名 为 “ServerForJSON”。 自 动 生 
成 工程 文件 后 ， 打 开 文件 web.xml 进行 配置 ， 配置 后 的 代码 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<web-app id="WebApp_ID" version="2.4" xmins="http://java.sun.com/xml/ns/j2ee"xmins:xsi= "http://www. 
w3.org/ 2001/XMLSchema-instance" xsi:schemaLocation-"http://java.sun.com/xml/ns/j2ee http://java.sun.com/ 
xml/ns/j2ee/web-app 2 4.xsd"» 
<display-name>ServerForJSON</display-name> 
<serviet> 
<display-name>NewsListServiet</display-name> 
<serviet-name>NewsListServiet</serviet-name> 
<serviet-class>com.guan.server.xml.NewsListServlet</serviet-class> 
</serviet> 
<serviet-mapping> 
<serviet-name>NewsListServiet</serviet-name> 
<url-pattern>/NewsListServiet</url-pattern> 
</servlet-mapping> 


<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 
</web-app> 
(2) 编写 业务 接口 Bean 的 实现 文件 NewsService.java， 具 体 实现 代码 如 下 : 
public interface NewsService { 


r 


* 获取 最 新 的 资讯 信息 
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Ы! 
public List<News> getLastNews(); 


ї 
设置 业务 Bean 的 名 称 为 NewsServiceBean， 实 现 文件 NewsServiceBean java 的 具体 实现 代码 如 下 : 
package com.guan.server.service.implement; 


import java.util. ArrayList; 
import java.util.List; 


import com.guan.server.domain.News; 
import com.guan.server.service.NewsService; 


public class NewsServiceBean implements NewsService { 
pe 
* 获 取 最 新 的 视频 资讯 
li 
public List<News> getLastNews()( 
List<News> newes = new ArrayList<News>(); 
newes.add(new News(10, "aaa", 20)); 
newes.add(new News(45, "bbb", 10)); 
newes.add(new News(89, "Android is good", 50)); 
return newes; 
) 
) 
(3) 创建 一 个 名 为 News 的 实现 类 ， 实 现 文件 News java 的 具体 实现 代码 如 下 : 
package com.guan.server.domain; 
public class News { 
private Integer id; 
private String title; 
private Integer timelength; 
public News(Integer id, String title, Integer timelength) { 


this.id = id; 
this.title = title; 
this.timelength = timelength; 

] 

public Integer getld() { 
return id; 

ji 

public void setld(Integer id) { 
this.id = id; 

h 

public String getTitle() { 
return title; 

) 

public void setTitle(String title) { 
this.title = title; 

lj 

public Integer getTimelength() { 
return timelength; 


@ 
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J 
public void setTimelength(Integer timelength) { 
this.timelength = timelength; 
} 
} 
(4) 编写 文件 NewsListServlet， 具 体 实现 代码 如 下 : 
public class NewsListServlet extends HttpServlet ( 
private static final long serialVersionUID = 1L; 
private NewsService newsService = new NewsServiceBean(); 
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, 
IOException { 
doPost(request, response); 
) 
protected void doPost(HttpServletRequest request, HttpServietResponse response) throws ServletException, 
IOException { 
List«News» newes = newsService.getLastNews();// 获 取 最 新 的 视频 资讯 
II [fid:20,title:"xxx" timelength:90},{id:10, title:"xbx" timelength:20}] 
StringBuilder json = new StringBuilder(); 
json.append(T); 
for(News news : newes)( 
json.append('{'); 
json.append("id:").append(news.getld()).append(","); 
json.append("title:\"").append(news.getTitle()).append("\","); 
json.append("timelength:").append(news.getTimelength()); 
json.append("},"); 
} 
json.deleteCharAt(json.length() - 1); 
json.append(]); 
request.setAttribute("json", json.toString()); 
request.getRequestDispatcher("/WEB-INF/page/jsonnewslist.jsp").forward(request, response); 
} 
} 
(5) 新 建 一 个 JSP 文件 jsonnewslistjsp， 在 其 中 引入 ISON 功能 ， 具 体 实现 代码 如 下 : 
<%@ page language="java" contentType="text/plain; charset=UTF-8" pageEncoding="UTF-8"%>${json} 
(6) 使 用 Eclipse 新 建 一 个 名 为 GetNewsInJSONFromInternet 的 Android 工程 文件 ， 在 文件 
AndroidManifest.xml 中 声明 对 网 络 权限 的 应 用 ， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«manifest xmins:android="http://schemas.android.com/apk/res/android” 
package="com.guan.internet.json" 
android:versionCode="1" 
android:versionName="1.0"> 
<application android:icon="@drawable/icon" android:label="@string/app_name"> 
«activity android:name-"com.guan.internet.json.MainActivity" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android.intent.action. MAIN" /> 
«category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
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<uses-sdk android:minSdkVersion="8" /> 
<1-- 访问 internet 权限 -> 
«uses-permission android:name="android.permission.INTERNET"/> 
</manifest> 


(7) 编写 主 界面 布局 文件 main.xml， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android” 
android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<ListView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:id="@+id/listView" 
> 
</LinearLayout> 
在 上 述 代码 中 ,通过 ListView 控件 列表 显示 获取 的 JSON 数据 。 其 中 ListView 的 Item 显示 的 数据 
为 item.xml， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-"horizontal" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


<TextView 
android:layout_width="200dp" 
android:layout height-"wrap content" 
android:id="@+id/title" 
> 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:id="@+id/timelength" 
> 
</LinearLayout> 
(8) 编写 文件 MainActivityjava， 功 能 是 获取 ISON 数据 并 显示 数据 ， 有 具体 实现 代码 如 下 : 
public class MainActivity extends Activity { 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
ListView listView = (ListView) this.findViewByld(R.id.listView); 


String length = this.getResources().getString(R.string.length); 
try { 
List<News> newes = NewsService.getJSONLastNews(); 
List<HashMap<String, Object>> data = new ArrayList<HashMap<String, Object>>(); 


@ 
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for(News news : newes){ 
HashMap<String, Object> item = new HashMap<String, Object>(); 
item.put("id", news.getld()); 
item.put("title", news.getTitle()); 
item.put("timelength", length news.getTimelength()); 
data.add(item); 
} 
SimpleAdapter adapter = new SimpleAdapter(this, data, R.layout.item, 
new String[]{"title", "timelength"}, new int[]{R.id.title, R.id.timelength}); 
listView.setAdapter(adapter); 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
} 

(9) 编写 文件 NewsServicejava， 定 义 方 法 geJSONLastNews( itt SR ñij [8135 LAY JavaEE 服务 器 ， 
当 获 取 ISON 输入 流 后 解析 ISON 的 数据 ， 并 返回 集合 中 的 数据 。 文 件 NewsService.java 的 具体 实现 代 
码 如 下 : 

public class NewsService { 
p 
* 获 取 最 新 视频 资讯 
d 
public static List<News> getJSONLastNews() throws Exception{ 
String path = "http://192.163.1.100:8080/ServerForJSON/NewsListServlet"; 
HttpURLConnection conn = (HttpURLConnection) new URL(path).openConnection(); 
conn.setConnectTimeout(5000); 
conn.setRequestMethod(" GET"); 
if(conn.getResponseCode() == 200)( 
InputStream json = conn.getinputStream(); 
return parseJSON(json); 
} 
return null; 
} 
private static ListsNews> parseJSON(InputStream jsonStream) throws Exception{ 
List<News> list = new ArrayList<News>(); 
byte[] data = StreamTool.read(jsonStream); 
String json = new String(data); 
JSONArray jsonArray = new JSONArray(json); 
for(int i = 0; i < jsonArray.length() ; i++} 
JSONObject jsonObject = jsonArray.getJSONObject(i); 
int id = jsonObject.getint("id"); 
String title = jsonObject.getString("title"); 
int timelength = jsonObject.getInt("timelength"); 
list.add(new News(id, title, timelength)); 
1 
return list; 
| 
lh 
至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 将 成 功 获取 服务 器 端 ISON 的 数据 。 
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为 了 节约 手机 的 存储 空间 ， 在 听 音 乐 时 可 以 用 从 网 络 中 下 载 的 方式 播放 MP3。 在 本 实例 中 ， 首 先 
插入 4 个 按钮 ， 分 别 用 于 播放 、 和 暂停 、 重 新 播放 和 停止 。 执 行 后 ， 通 过 Runnable 发 起 运行 线程 ， 在 线 
程 中 通过 网 络 传输 方式 远程 下 载 指定 的 MP3 文件 。 下 载 完毕 后 ， 临 时 保存 到 SD 卡 中 ， 这 样 可 以 通过 
4 个 按钮 对 其 进行 控制 。 当 关闭 程序 后 ， 会 自动 删除 SD 卡 中 的 临时 性 文件 。 


编写 主 程序 文件 mp.java， 具 体 实现 流程 如 下 所 示 。 
(1) 定义 方法 currentFilePath 用 于 记录 当前 正在 播放 МРЗ 的 URL 地 址 , 定义 currentTempFilePath 
表示 当前 播放 MP3 的 路 径 。 具 体 实 现代 码 如 下 : 
”记录 当前 正在 播放 МРЗ 的 地 址 URL*/ 
private String currentFilePath = ""; 
/当前 播放 МРЗ 的 路 径 */ 
private String currentTempFilePath = ""; 
private String strVideoURL = ""; 
(2) 使 用 strVideoURL 设置 要 播放 МРЗ 文件 的 网 址 ， 并 设置 透明 度 。 有 具体 实现 代码 如 下 : 
public void onCreate(Bundle savedinstanceState) 
{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
"МРЗ 文件 不 会 被 下 载 到 local*/ 
strVideoURL = "http://www.Irn.cn/zywh/xyyylyyxs/200805/W020080505536315331313.mp3"; 
mTextView01 = (TextView)findViewByld(R.id.myTextView1); 
MEZAR 
getWindow().setFormat(PixelFormat. TRANSPARENT); 
mPlay = (ImageButton)findViewByld(R.id.play); 
mReset = (ImageButton)findViewByld(R.id.reset); 
mPause = (ImageButton)findViewByld(R.id.pause); 
mStop = (ImageButton)findViewByld(R.id.stop); 
(3) 编写 单 击 “ 播 放 ” 按 钮 所 触发 的 处 理事 件 ， 具 体 实现 代码 如 下 : 
/播放 按钮 */ 
mPlay.setOnClickListener(new ImageButton.OnClickListener() 
{ 


public void onClick(View view) 


{ 

六 调用 播放 影片 Function*/ 

playVideo(strVideoURL); 

mTextView01.setText 

( 

getResources().getText(R.string.str_play).toString()+ 

"\n"+ strVideoURL 
); 


(4) 编写 单 击 “ 重 播 ” 按 钮 所 触发 的 处 理事 件 ， 具 体 实现 代码 如 下 : 


/* 重新 播放 */ 
mReset.setOnClickListener(new ImageButton.OnClickListener() 


public void onClick(View view) 


{ 


if(blsReleased == false) 


if (mMediaPlayer01 != null) 

{ 
mMediaPlayer01.seekTo(0); 
mTextViewO01.setText(R.string.str play); 


) 
H 

) 
}; 

(5) 编写 单 击 “ 和 暂停 ”按钮 所 触发 的 处 理事 件 ， 具 体 实现 代码 如 下 : 
A* 暂 停 播放 */ 
mPause.setOnClickListener(new ImageButton.OnClickListener() 
{ 

public void onClick(View view) 

{ 


if (mMediaPlayer01 != null) 
{ 


if(blsReleased == false) 
{ 
if(blsPaused==false) 
{ 
mMediaPlayer01 .pause(); 
blsPaused = true; 
mTextView01.setText(R.string.str_pause); 


} 

else if(blsPaused==true) 

{ 
mMediaPlayer01.start(); 
blsPaused = false; 
mTextView01.setText(R.string.str_play); 

} 

} 
} 
} 
}); 


(6) 编写 单 击 “ 停 止 ” 按 钮 所 触发 的 处 理事 件 ， 具 体 实现 代码 如 下 : 


ib") 
mStop.setOnClickListener(new ImageButton.OnClickListener() 


public void onClick(View view) 
{ 

try 

{ 


gs speras | 
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if (mMediaPlayer01 !- null) 
{ 
if(blsReleased==false) 
{ 
mMediaPlayer01.seekTo(0); 
mMediaPlayer01.pause(); 
//mMediaPlayer01-.stop(); 
//mMediaPlayer01 .release(); 
//blsReleased = true; 
mTextView01.setText(R.string.str_stop); 
} 
} 


catch(Exception e) 


mTextView01.setText(e.toString()); 
Log.e(TAG, e.toString()); 
e.printStackTrace(); 


} 
| D: 
(7) 定义 方法 playVideo(final String strPath) 来 播放 指定 的 MP3， 其 播放 的 是 存储 卡 中 和 暂时 保存 的 
MP3 文件 ， 具 体 实现 代码 如 下 : 
private void playVideo(final String strPath) 
{ 
try 


if (strPath.equals(currentFilePath)&& mMediaPlayer01 != null) 
{ 
mMediaPlayer01.start(); 
return; 
} 
currentFilePath = strPath; 
mMediaPlayer01 = new MediaPlayer(); 
mMediaPlayer01.setAudioStreamType(2); 
(8) 编写 setOnErrorListener 来 监听 错误 处 理 ， 有 具体 实现 代码 如 下 : 
”错误 事件 */ 
mMediaPlayer01.setOnErrorListener(new MediaPlayer.OnErrorListener() 
{ 
@Override 
public boolean onError(MediaPlayer mp, int what, int extra) 


{ 
Log.i(TAG, "Error on Listener, what: " + what + "extra: " + extra); 


return false; 
} 
D: 
(9) 编写 setOnBufferingUpdateListener 来 监听 MediaPlayer 缓冲 区 的 更 新 ， 具 体 实现 代码 如 下 : 
/捕捉 使 用 MediaPlayer 缓冲 区 的 更 新 事件 */ 
mMediaPlayer01.setOnBufferingUpdateListener(new MediaPlayer.OnBufferingUpdateListener() 


(m, 
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{ 
@Override 
public void onBufferingUpdate(MediaPlayer mp, int percent) 
{ 
Log.i(TAG, "Update buffer: " + Integer.toString(percent)+ "%"); 
} 
}); 
(10) 编写 setOnCompletionListener 来 监听 播放 完毕 所 触发 的 事件 ， 具 体 实现 代码 如 下 : 
"播放 完毕 所 触发 的 事件 */ 
mMediaPlayer01.setOnCompletionListener(new MediaPlayer.OnCompletionListener() 
{ 
@Override 
public void onCompletion(MediaPlayer mp) 
Í 
IIdelFile(currentTempFilePath); 
Log.i(TAG,"mMediaPlayer01 Listener Completed"); 
) 
ys 
(11) 编写 setOnPreparedListener 来 监听 开始 阶段 的 事件 ， 具 体 实现 代码 如 下 : 
A 开始 阶段 的 监听 Listener*/ 
mMediaPlayer01.setOnPreparedListener(new MediaPlayer.OnPreparedListener() 
{ 
@Override 
public void onPrepared(MediaPlayer mp) 
Í 
Log.i(TAG,"Prepared Listener"); 
} 
}); 
(12) 将 文件 存 到 SD 卡 后 ， 通 过 方法 mMediaPlayer01.start0) 播 放 MP3 。 有 具体 实现 代码 如 下 : 
/用 Runnable 来 确保 文件 在 存储 完毕 后 才 开始 start()*/ 
Runnable r = new Runnable() 


public void run() 
{ 
try 


{ 
/*setDataSource 将 文件 存 到 SD -k*/ 


setDataSource(strPath); 

/因为 线程 顺利 进行 ， 所 以 在 setDataSource 后 运行 prepare()*/ 
mMediaPlayer01.prepare(); 

Log.i(TAG, "Duration: " + mMediaPlayer01.getDuration()); 


开始 播放 MP3*/ 
mMediaPlayer01.start(); 
blsReleased = false; 


} 
catch (Exception e) 


{ 
Log.e(TAG, e.getMessage(), е); 


} 
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} 
k 
new Thread(r).start(); 
} 
(13) 如 果 有 异常 则 输出 提示 ， 具 体 实现 代码 如 下 : 
catch(Exception е) 
{ 
if (mMediaPlayer01 != null) 


{ 
PRIR E RE USERE 
mMediaPlayer01.stop(); 
mMediaPlayer01.release(); 


} 
e.printStackTrace(); 
} 
} 
(14) 定义 函数 setDataSource 用 于 存储 URL 的 MP3 文件 到 存储 卡 。 首 先 判断 传 入 的 地 址 是 否 为 
URL， 然 后 创建 URL 对 象 和 临时 文件 。 有 具体 实现 代码 如 下 : 
/定义 函数 用 于 存储 URL 的 МРЗ 文件 到 存储 卡 */ 
private void setDataSource(String strPath) throws Exception 


{ 
/判断 传 入 的 地 址 是 否 为 URL*/ 
if (IURLUtil.isNetworkUrl(strPath)) 


{ 
mMediaPlayer01.setDataSource(strPath); 
} 


else 
if(blsReleased == false) 


{ 
/创建 URL 对 象 */ 
URL myURL = new URL(strPath); 
URLConnection conn = myURL.openConnection(); 
conn.connect(); 


/获取 URLConnection 的 InputStream*/ 
InputStream is = conn.getInputStream(); 
if (is == null) 

{ 


throw new RuntimeException("stream is null"); 


} 

站 创建 临时 文件 */ 

File myTempFile = File.createTempFile("yinyue", "."+getFileExtension(strPath)); 
currentTempFilePath = myTempFile.getAbsolutePath(); 

FileOutputStream fos = new FileOutputStream(myTempFile); 

byte buf[] = new byte[128]; 

do 


int numread - is.read(buf); 


if (numread <= 0) 


{ 
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break; 


fos.write(buf, 0, numread); 
}while (true); 


/直到 fos 存储 完毕 ， 调 用 MediaPlayer.setDataSource */ 
mMediaPlayer01.setDataSource(currentTempFilePath); 
try 

{ 


is.close(); 


} 


catch (Exception ex) 


{ 
Log.e(TAG, "error: " + ex.getMessage(), ех); 
} 
} 
} 
} 
(15) 定义 方法 getFileExtension(String strFileName) 来 获取 音乐 文件 的 扩展 名 ， 如 果 无 法 顺利 获取 
扩展 名 ， 则 默认 为 .dat。 具 体 实现 代码 如 下 : 
/获取 音乐 文件 扩展 名 自 定义 函数 
private String getFileExtension(String strFileName) 
{ 
File myFile = new File(strFileName); 
String strFileExtension=myFile.getName(); 
strFileExtension=(strFileExtension.substring(strFileExtension.lastIndexOf(".")+1)).toLowerCase(); 
if(strFileExtension=="") 


{ 
Tn RC SEGUE TR RIT RA MERA 23. dat/ 
strFileExtension = "dat"; 

} 


return strFileExtension; 
} 
(16) 定义 方法 delFile(String strFileName) 来 设置 当 离开 程序 时 删除 临时 音乐 文件 ， 有 具体 实现 代码 
如 下 : 
* 离 开 程序 时 需要 调用 自 定义 函数 删除 临时 音乐 文件 */ 
private void delFile(String strFileName) 


File myFile = new File(strFileName); 
if(myFile.exists()) 


myFile.delete(); 


} 


@Override 
protected void onPause() 


{ 
/删除 临时 文件 7/ 
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try 
delFile(currentTempFilePath); 

) 

catch(Exception e) 

{ 


e.printStackTrace(); 
} 


super.onPause(); 
| } 
执行 后 可 以 通过 播放 、 和 暂停 、 重 新 播放 和 停止 4 个 按钮 来 控制 播放 指定 的 MP3 音乐 ， 如 图 3-5 


所 示 。 


图 3-5 执行 效果 


3.4 上 传 数据 


Фин 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 3 章 \ 上 传 数据 .avi 

“上 传 ” 和 “下 载 ”是 相对 的 ， 上 传 是 指 将 信息 从 个 人 计算 机 (本 地 计算 机 ) 传递 到 中 央 计 算 机 
(远程 计算 机 》 系统 上 ， 让 网 络 上 的 人 都 能 看 到 。 本 节 将 详细 讲解 在 Android 物 联网 设备 中 上 传 数 据 
的 基本 知识 ， 为 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 
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在 使 用 物 联网 设备 时 ， 可 以 使 用 拍照 装置 进行 拍照 。 为 了 节省 设备 的 容量 ， 可 以 将 照片 上 传 到 远 
程 服务 器 。 例 如 在 下 面 的 实例 中 ， 演 示 了 在 Android 物 联网 设备 中 将 文件 上 传 到 远程 服务 器 的 方法 。 


B OB | BH 的 | 源码 路 径 
实例 3-6 上 传 物 联网 设备 中 的 文件 到 远程 服务 器 光盘 :daima\3\chuanEX 


程序 文件 chuanjava， 具 体 实现 流程 如 下 。 
a) 分 别 声明 变量 newName、uploadFile 和 actionUrl， 具 体 实现 代码 如 下 : 
public class chuan extends Activity 


E 
/变量 声明 
*newName: 上 传 后 在 服务 器 上 的 文件 名 称 
*uploadFile: 要 上 传 的 文件 路 径 
*actionUrl: 服务 器 上 对 应 的 程序 路 径 */ 
private String newName="image.jpg"; 
private String uploadFile="/data/data/irdc.example9/image jpg"; 
private String actionUrl="http://127.127.0.1/upload/upload jsp"; 


e. 
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private TextView mText1; 
private TextView mText2; 
private Button mButton; 


(2) 通过 mTextl 对 象 获 取 文 件 路 径 ， 根 据 mTexO 设置 上 传 网 址 ， 单 击 按钮 后 调用 上 传 方法 


uploadFile()。 具 体 实现 代码 如 下 : 


public void onCreate(Bundle savedinstanceState) 


{ 


} 


super.onCreate(savedlInstanceState); 
setContentView(R.layout.main); 
mText1 = (TextView) findViewByld(R.id.myText2); 
mText1.setText(" 文 件 路 径 : \n"+uploadFile); 
mText2 = (TextView) findViewByld(R.id.myText3); 
mText2.setText(" 上 传 网 址 : \n"+actionUrl); 
/设置 mButton 的 onClick 事件 处 理 */ 
mButton = (Button) findViewByld(R.id.myButton); 
mButton.setOnClickListener(new View.OnClickListener() 
í 

public void onClick(View v) 

( 

uploadFile(); 

} 

}; 


(3) 定义 方法 uploadFile0， 将 文件 上 传 至 Server， 具 体 实现 代码 如 下 : 


/* 上 传 文件 至 Server 的 方法 */ 
private void uploadFile() 


{ 


String end = "\r\n"; 

String twoHyphens = "--"; 

String boundary = "*****"; 

try 

{ 
URL url =new URL(actionUrl); 
HttpURLConnection con=(HttpURLConnection)url.openConnection(); 
FY Input, Output, FEA Cache*/ 
con.setDolnput(true); 
con.setDoOutput(true); 
con.setUseCaches(false); 
上 设置 传送 的 method=POST */ 
con.setRequestMethod("POST"); 
/*setRequestProperty*/ 
con.setRequestProperty("Connection", "Keep-Alive"); 
con.setRequestProperty("Charset", "UTF-8"); 
con.setRequestProperty("Content-Type”,"multipart/form-data;boundary="+boundary); 
M&E DataOutputStream*/ 
DataOutputStream ds = 

new DataOutputStream(con.getOutputStream()); 
ds.writeBytes(twoHyphens + boundary + end); 
ds.writeBytes("Content-Disposition: form-data; " + 
“name=\"file1\":filename=\"" + 


8) 


= 


n Android 物 联网 开发 从 入 门 到 实战 


newName +"\"" + end); 
ds.writeBytes(end); 
/* 取 得 文件 的 FilelnputStream*/ 
FilelnputStream fStream = new FilelnputStream(uploadFile); 
В ХЕ A 1024bytes*/ 
int bufferSize = 1024; 
byte[] buffer = new byte[bufferSize]; 
int length = -1; 
/从 文件 读 取 数 据 至 缓冲 区 %/ 
while((length = fStream.read(buffer)) != -1) 


/* 将 资料 写 入 DataOutputStream 中 */ 
ds.write(buffer, 0, length); 
} 
ds.writeBytes(end); 
ds.writeBytes(twoHyphens + boundary + twoHyphens + end); 
fStream.close(); 
ds.flush(); 
"48 Response 内 容 */ 
InputStream is = con.getInputStream(); 
int ch; 
StringBuffer b =new StringBuffer(); 
while( ( ch = is.read() ) != -1 ) 


b.append( (char)ch ); 


) 

/将 Response 显示 在 Dialog 对 话 框 中 */ 
showDialog(b.toString().trim()); 

/关闭 DataOutputStream*/ 

ds.close(); 


catch(Exception e) 


showDialog(""+e); 
} 
} 
(4) 定义 方法 showDialog(String mess) 来 显示 提示 对 话 框 ， 具 体 实现 代码 如 下 : 
/* 显 示 Dialog 的 方法 */ 
private void showDialog(String mess) 


new AlertDialog.Builder(example9.this).setTitle("Message") 
.setMessage(mess) 
.setNegativeButton(" fi ze" new Dialoginterface.OnClickListener() 


{ 
public void onClick(DialogInterface dialog, int which) 


азе BABERE — 


执行 后 单 击 “ 上 传 ”按钮 可 以 将 指定 的 文件 上 传 到 服务 器 ， 如 图 3-6 所 示 。 


上 传 到 服务 器 


文件 路 径 
idata/data/irdc shili9/image. 


i 
http;//127.127.0. /upload/upload jsp. 


fe 


图 3-6 执行 效果 
3.4.2 ”实战 演练 一 一 使 用 GET 方式 上 传 数据 


在 Android 系统 中 可 以 通过 GET 方式 或 POST 方式 上 传 数据 ， 本 节 将 通过 一 个 具体 实例 的 实现 过 
程 ， 介 绍 在 Android 物 联 网 设备 中 采用 GET 方式 向 服务 器 传递 数据 的 基本 方法 。 


题 目 | H m | 源码 路 径 : 
.实例 3-7 | 在 物 联网 设备 中 采用 GET 方式 向 服务 器 传递 数据 eait:\daima\3\getEX — 


(1) 创建 一 个 名 为 ServletForGETMethod 的 Servlet， 功 能 是 接收 并 处 理 通过 GET 方式 上 传 的 数 


据 。 文 件 ServletForGETMethod.java 的 具体 实现 代码 如 下 : 
@WebServiet("/ServietForGET Method") 
public class ServletForGETMethod extends HttpServlet { 
private static final long serialVersionUID = 1L; 
protected void doGet(HttpServletRequest request, HttpServietResponse response) throws ServletException, 
IOException { 
String name= request.getParameter("name"); 
Il String name= new String(request.getParameter("name").getBytes("ISO8859-1"),"UTF-8"); 
String age= request.getParameter("age"); 
System.out.printin("name: " + name ); 
System.out.printin("age: " + age ); 


} 


} 
在 上 述 代 码 中 ， 为 了 避免 出 现 中 文 乱码 的 问题 ， 特 意 实 现 了 1508859-1 和 UTF-8 转换 处 理 。 下 面 


的 代码 很 好 地 解决 了 乱码 问题 。 
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 
<% 


String zh_value=new String(request.getParameter("zh_value").getBytes("ISO-8859-1"),"UTF-8") 
%> 
由 此 可 见 ， 在 使 用 get 方式 传递 数据 时 ， 需 要 使 用 如 下 所 示 的 代码 声明 当前 页 的 字符 集 。 
pageEncoding="UTF-8" /声明 当前 页 的 字符 集 

(2) 在 配置 文件 web.xml 中 配置 ServletForGETMethod， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmins:xsi="http:/www.w3.org/2001/XMLSchema-instance" xmlns-http://java.sun.com/xml/ns/javaee 
xmins:web-"http://java.sun.com/xml/ns/javaee/web-app 2 5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ 
ns/javaee http://java.sun.com/xml/ns/javaee/web-app 3 0.xsd" id-"WebApp ID" version="3.0"> 

<display-name>ServerForGET Method</display-name> 

® 
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<servlet> 
<display-name>ServletForGETMethod</display-name> 
<serviet-name>ServietForGET Method</serviet-name> 
<serviet-class>com.guan.internet.serviet.ServietForGET Method</serviet-class> 

</serviet> 

<serviet-mapping> 
<serviet-name>ServietForGETMethod</serviet-name> 
<url-pattern>/ServietForGETMethod</url-pattern> 

</serviet-mapping> 

<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.htm</welcome-file> 
<welcome-file>index.jsp</welcome-file> 
<welcome-file>default.html</welcome-file> 
<welcome-file>default.htm</welcome-file> 
<welcome-file>default.jsp</welcome-file> 

</welcome-file-list> 

</web-app> 


(3) 47F Eclipse, 新 建 一 个 名 为 UserInformation 的 Android 工程 。 然 后 编写 界面 布局 文件 main.xml, 
具体 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/title" 
> 
<EditText 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:id="@+id/title" 
> 


<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/length" 
> 
<EditText 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:numeric-"integer" 
android:id="@+id/length" 
> 
<Button 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text="@string/button" 
android:onClick="save" 
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I 
</LinearLayout> 


(4) 编写 文件 UserInformationActivityjava， 具 体 实现 代码 如 下 : 
public class UserlnformationActivity extends Activity { 
private EditText titleText; 
private EditText lengthText; 


@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


titleText = (EditText) this.findViewByld(R.id.title); 
lengthText = (EditText) this.findViewByld(R.id.length); 
} 


public void save(View v)( 
String title = titleText.getText().toString(); 
String length = lengthText.getText().toString(); 
try { 

boolean result = false; 


result = UserinformationService.save(title, length); 


if(result){ 
Toast.makeText(this, R.string.success, 1).show(); 
}else{ 
Toast.makeText(this, R.string.fail, 1).show(); 
} 
} catch (Exception e) { 
e.printStackTrace(); 
Toast.makeText(this, R.string.fail, 1).show(); 


} 
} 
(5) 编写 业务 类 的 实现 文件 UserInformationService.java， 主 要 实现 代码 如 下 : 
public class UserlnformationService { 
public static boolean save(String title, String length) throws Exception{ 
String path = "http://192.163.1.100:8080/ServerForGETMethod/ServletForGETMethod"; 
Map<String, String> params = new HashMap<String, String>(); 
params.put("name", title); 
params.put("age", length); 
return sendGETRequest(path, params, "UTF-8"); 
1 
pt 
* 发 送 GET 请 求 
*@param path 请 求 路 径 
*@param params 请 求 参数 
Wi 
private static boolean sendGETRequest(String path, Map<String, String> params, String encoding) throws 
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Exception{ 
http://192.173.1.100:8080/ServerForGETMethod/ServietForGET Method ?title=xxxx&length=90 


} 


(6) 在 配置 文件 AndroidManifest.xml 中 声明 网 络 访问 权限 ， 


StringBuilder sb = new StringBuilder(path); 
if(params!=null && !params.isEmpty()){ 
sb.append("?"); 
for(Map.Entry<String, String> entry : params.entrySet()){ 
sb.append(entry.getKey()).append("="); 
sb.append(URLEncoder.encode(entry.getValue(), encoding)); 
sb.append("&"); 
} 
sb.deleteCharAt(sb.length() - 1); 
} 


HttpURLConnection conn = (HttpURLConnection) new URL(sb.toString()).openConnection(); 


conn.setConnectTimeout(5000); 

conn.setRequestMethod("GET"); 

if(conn.getResponseCode() == 200){ 
return true; 

} 

return false; 


} 


<uses-sdk android:minSdkVersion="18" /> 


<application 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name" > 
<activity 
android:label="@string/app_name" 


主要 实现 代码 如 下 : 


android:name-"com.guan.internet.userInformation.get.UserlnformationActivity" > 


<intent-filter > 
«action android:name="android.intent.action. MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android.permission.INTERNET"/> 


</manifest> 
至 此 ， 整 个 实例 讲解 完毕 ， 执 行 后 的 效果 如 图 3-7 所 示 。 输 入 用 户 名 和 年 
将 输入 的 数据 上 传 至 服务 器 。 


图 3-7 执行 效果 


P 
we 


后 单 击 save 按钮 ， 会 


взе вживав | 


34.3 ”实战 演练 一 一 使 用 POST 方式 上 传 数据 


在 Android 物 联 网 设备 中 ， 采 用 POST 方式 向 服务 器 传递 数据 的 基本 步骤 如 下 : 
COD 利用 Map 集合 获取 数据 并 进行 数据 处 理 。 
(2) 新 建 一 个 StringBuilder 对 象 ， 得 到 POST 传 给 服务 器 的 数据 。 
G) 新 建 一 个 HttpURLConnection 的 URL 对 象 ， 打 开 连 接 并 传递 服务 器 的 path， 设 置 超时 和 人 允 
许 对 外 连接 数据 。 
(4) 设置 连接 的 setRequestProperty 属性 ， 并 得 到 连接 输出 流 。 
outputStream =connection.getOutputStream(); 
(5) 把 得 到 的 数据 写 入 输出 流 中 并 刷新 。 
下 面 将 通过 一 个 具体 实例 的 实现 过 程 ， 介 绍 在 Android 物 联 网 设备 中 采用 POST 方式 向 服务 器 传 
递 数据 的 方法 。 


(1) 创建 一 个 名 为 ServletForPOSTMethod 的 Servlet， 功 能 是 接收 并 处 理 通过 POST 方式 上 传 的 


数据 。 实 现 文件 ServletForPOSTMethod.java 的 具体 实现 代码 如 下 : 
@WebServlet("/ServietForPOSTMethod") 
public class ServletForPOSTMethod extends HttpServlet { 
private static final long serialVersionUID = 1L; 
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, 
1ОЕхсеріоп { 
String name= request.getParameter("name"); 
String age= request.getParameter("age"); 
System.out.printin("name from POST method: " + name ); 
System.out.printin("age from POST method: " + age ); 
} 
} 
(2) 在 配置 文件 web.xml 中 配置 ServletForGETMethod， 具 体 实 现代 码 如 下 : 
<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmins:xsi="http:/www.w3.org/2001/XMLSchema-instance" xmlns-http://java.sun.com/xml/ns/javaee 
xmins:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
xsi:schemaLocation-"http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app 3 0.xsd" id= 
"WebApp ID" version="3.0"> 
«display-name»ServerForPOSTMethod«/display-name» 
<welcome-file-list> 
<welcome-file>index.html</welcome-file> 
<welcome-file>index.htm</welcome-file> 
<welcome-file>index.jsp</welcome-file> 
<welcome-file>default.html</welcome-file> 
<welcome-file>default.htm</welcome-file> 
<welcome-file>default.jsp</welcome-file> 
</welcome-file-list> 
</web-app> 
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(3) 打开 Eclipse， 新 建 一 个 名 为 POST 的 Android 工程 。 然 后 编写 界面 布局 文件 main. xml, АЖ 
实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
android:orientation-" vertical" > 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/title" 
> 
<EditText 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:id="@+id/title" 
> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/length" 
> 
<EditText 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:numeric-"integer" 
android:id="@+id/length" 
> 
<Button 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text="@string/button" 
android:onClick="save" 
> 
</LinearLayout> 
(4) 编写 文件 UploadUserInformationByPOSTActivityjava， 有 具体 实现 代码 如 下 : 
public class UploadUserInformationByPOSTActivity extends Activity { 
private EditText titleText; 
private EditText lengthText; 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


title Text = (EditText) this.findViewByld(R id title); 
lengthText = (EditText) this.findViewByld(R.id.length); 
} 


public void save(View v)( 
String title = titleText.getText().toString(); 
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String length = lengthText.getText().toString(); 


try{ 
boolean result = false; 


result = UploadUserInformationByPostService.save(title, length); 


if(result){ 
Toast.makeText(this, R.string.success, 1).show(); 
Jelse( 
Toast.makeText(this, R.string fail, 1).show(); 
| 
} catch (Exception e) { 
e.printStackTrace(); 
Toast.makeText(this, R.string.fail, 1).show(); 


} 
} 
(5) 编写 业务 类 的 实现 文件 UploadUserInformationByPostService.java， 主 要 实现 代码 如 下 : 
public class UploadUserinformationByPostService { 
public static boolean save(String title, String length) throws Exception{ 
String path = "http://192.163.1.100:8080/ServerForPOSTMethod/ServletForPOSTMethod"; 
Map<String, String> params = new HashMap<String, String>(); 
params.put("name", title); 
params.put("age", length); 
return sendPOSTRequest(path, params, "UTF-8"); 
} 


p 
* 发 送 POST 请 求 
*@param path 请 求 路 径 
*@param params 请 求 参数 
у 
private static boolean sendPOSTRequest(String path, Map<String, String> params, String encoding) 
throws Exception{ 
|| title=liming&length=30 
StringBuilder sb = new StringBuilder(); 
if(params!=null && !params.isEmpty()){ 
for(Map.Entry<String, String> entry : params.entrySet()){ 
sb.append(entry.getKey()).append("="); 
sb.append(URLEncoder.encode(entry.getValue(), encoding)); 
sb.append("&"); 


} 

sb.deleteCharAt(sb.length() - 1); 
} 
byte[] data = sb.toString().getBytes(); 


HttpURLConnection conn = (HttpURLConnection) new URL(path).openConnection(); 
conn.setConnectTimeout(5000); 

conn.setRequestMethod(" POST"); 

conn.setDoOutput(true);// 允 许 对 外 传输 数据 
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); 
conn.setRequestProperty("Content-Length", data.length+""); 
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OutputStream outStream = conn.getOutputStream(); 
outStream.write(data); 
outStream.flush(); 
if(conn.getResponseCode() == 200)( 
return true; 
} 
return false; 
} 
} 
(6) 编写 配置 文件 AndroidManifestxml， 声 明 网 络 访问 权限 ， 主 要 实现 代码 如 下 : 
«manifest xmIns:android-"http://schemas.android.com/apk/res/android" 
package="com.guan.internet.userinformation.post" 
android:versionCode="1" 
android:versionName="1.0" > 
<uses-sdk android:minSdkVersion="8" /> 
<application 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name" > 
<activity 
android:label="@string/app_name" 
android:name="com.guan.internet.userinformation.post.UploadUserinformationByPOSTActivity" > 
<intent-filter > 
«action android:name-"android.intent.action. MAIN" /> 
«category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android.permission.INTERNET"/> 
</manifest> 


至 此 ， 整 个 实例 讲解 完毕 ， 执 行 后 的 效果 如 图 3-8 所 示 。 输 入 用 户 名 和 年 龄 后 单 击 save 按钮 ， 会 
将 输入 的 数据 上 传 至 服务 器 。 


lUploadUserinformationByPOST 


图 3-8 执行 效果 
3.5 处 理 XML 数据 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 3 章 \ 处 理 XML 数据 .avi 
XML (eXtensible Markup Language) 即 可 扩展 标记 语言 ， 与 HIML 一 样 ， 都 是 SGML (Standard 
Generalized Markup Language， 标 准 通用 标记 语言 )。XML 是 Internet 环境 中 跨 平台 的 ， 依 赖 于 内 容 的 
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技术 ,是 当前 处 理 结构 化 文档 信息 的 有 力 工具 。 扩展 标记 语言 XML 是 一 种 简单 的 数据 存储 语言 ， 使 用 
一 系列 简单 的 标记 描述 数据 , 而 这 些 标 记 可 以 用 方便 的 方式 建立 , 虽然 XML 占用 的 空间 要 比 二 进 制 数 
据 多 ， 但 是 XML 极其 简单 ， 易 于 掌握 和 使 用 。 本 节 将 详细 讲解 在 Android 智能 设备 中 处 理 XML 数据 
的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


3.5.1 XML 的 概述 


XML j Access, Oracle 和 SQL Server 等 数据 库 不 同 , 数据 库 提供 了 更 强 有 力 的 数据 存储 和 分 析 能 
力 ， 例 如 数据 索引 、 排 序 、 查 找 、 相 关 一 致 性 等 ，XML 仅 是 展示 数据 。 事 实 上 XML 与 其 他 数据 表现 
形式 最 大 的 不 同 是 它 极 其 简单 ， 这 是 一 个 看 上 去 有 点 琐 细 的 优点 ， 但 正 是 这 点 使 XML 与 众 不 同 。 

XML 的 简单 使 其 易于 在 任何 应 用 程序 中 读 写 数据 , 这 使 XML 很 快 成 为 数据 交换 的 唯一 公共 语言 ， 
虽然 不 同 的 应 用 软件 也 支持 其 他 的 数据 交换 格式 ， 但 不 久之 后 它们 都 将 支持 XML， 那 就 意味 着 程序 可 
以 更 容易 地 与 Windows. Mac OS. Linux 以 及 其 他 平台 下 产生 的 信息 结合 , 然后 可 以 很 容易 地 加 载 XML 
数据 到 程序 中 并 分 析 它 ， 并 以 XML 格式 输出 结果 。 

为 了 使 得 SGML 显得 用 户 友好 ，XML 重新 定义 了 SGML 的 一 些 内 部 值 和 参数 ， 去 掉 了 大 量 的 很 
少 用 到 的 功能 ， 这 些 繁杂 的 功能 使 得 SGML 在 设计 网 站 时 显得 复杂 化 。XML 保留 了 SGML 的 结构 化 
功能 ， 这 样 就 使 得 网 站 设计 者 可 以 定义 自己 的 文档 类 型 ， XML 同时 也 推出 一 种 新 型 文档 类 型 ， 使 得 开 
发 者 也 可 以 不 必定 义 文档 类 型 。 

因为 XML 是 W3C 制定 的 ，XML 的 标准 化 工作 由 W3C 的 XML 工作 组 负责 ， 该 小 组 成 员 由 来 自 
各 个 地 方 和 行业 的 专家 组 成 ,他 们 通过 Email 交流 对 XML 标准 的 意见 , 并 提出 自己 的 看 法 (www.w3.org/ 
TR/WD-xml)。 因 为 XML 是 一 个 公共 格式 , 可 以 无 须 担心 XML BOR Z S BA a] A T... XML 
不 是 一 个 依附 于 特定 浏览 器 的 语言 。 


3.5.2 XML 的 语法 


上 面 虽然 讲解 了 XML 的 特点 ， 但 是 初学 者 仍然 不 明白 XML 是 用 来 做 什么 的 ， 其 实 XML 什么 也 
不 做 ， 它 只 是 用 来 存储 数据 的 ， 对 HTML 语言 进行 扩展 ， 它 和 HTML 分 工 很 明显 ，XML 是 用 来 存储 
数据 ， 而 HTML 是 用 来 如 何 表现 数据 的 ， 下 面 通过 一 段 程序 代码 进行 讲解 ， 其 代码 〈3-2.xml) Wr: 

<?xml version="1.0" encoding="utf-8"?> 

<book> 

<person> 

<first>Kiran</first> 

<last>Pai</last> 

<age>22</age> 

</person> 

<person> 

<first>Bill</first> 

<last>Gates</last> 

<age>46</age> 

</person> 

<person> 

<first>Steve</first> 

<last>Jobs</last> 
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<age>40</age> 
</person> 
</book> 
上 面 的 语法 还 可 以 写成 汉语 ， 如 下 面 (3-3-xmD 的 代码 : 
<?xml version="1.0" encoding="utf-8"?> 
< 项 目 > 
< 名 > 天 上 星 </ 名 > 
< 电子 邮件 >tianshangxing@hotmail.com</ 电 子 邮 件 > 
< 住宅 > 何 国 何 市 何 区 何 街道 何 番号 </ 住 宅 > 
< 电话 >83-021-742745674</ 电 话 > 
< 一 言 >XML 学 习 </ 一 言 > 
</ 项 目 > 
从 上 面 两 段 代码 可 以 看 出 ，XML 的 标记 完全 自由 定义 ， 不 受 约束 ， 它 只 是 用 来 存储 信息 ， 除 了 第 
一 行 固定 以 外 ， 其 他 的 只 需 前 后 标签 一 致 ， 末 标签 不 能 省 略 ， 下 面 将 XML 语法 格式 总 结 如 下 。 
在 第 一 行 必须 对 XML 进行 声明 ， 也 即 声明 XML 的 版 本 。 
它 的 标记 和 HTML 一 样 是 成 双 成 对 出 现 的 。 
XML 对 标记 的 大 小 写 十 分 敏感 。 
M XML 标记 是 用 户 自行 定义 ， 但 是 每 一 个 标记 必须 有 结束 标记 。 


3.5.3 ”获取 XML 文档 


如 何 获取 XML 文档 十 分 简单 , 下 面 通过 一 个 简单 的 Java 代码 获取 3.5.2 节 讲 解 的 3-2.xml 中 信息 ， 
其 代码 如 下 : 

import java.io.File; 

import org.w3c.dom.Document; 

import org.w3c.dom.*; 

import javax.xml.parsers.DocumentBuilderFactory; 

import javax.xml.parsers.DocumentBuilder; 

import org.xml.sax.SAXException; 

import org.xml.sax.SAXParseException; 

public class ReadAndPrintXMLFile{ 

public static void main (String argv []){ 

try { 

DocumentBuilderFactory docBuilderFactory 

= DocumentBuilderFactory.newlInstance(); 
DocumentBuilder docBuilder 

= docBuilderFactory.newDocumentBuilder(); 
Document doc = docBuilder.parse (new File("3-2.xml")); 
doc.getDocumentElement ().normalize (); 
System.out.printin ("Root element of the doc is " 

+ doc.getDocumentElement().getNodeName()); 
NodeList listOfPersons = doc.getElementsByTagName("person"); 
int totalPersons = listOfPersons.getLength(); 
System.out.printin("Total no of people : " + totalPersons); 
for(int s=0; s<listOfPersons.getLength() ; s++)( 

Node firstPersonNode = listOfPersons. item(s); 
if(firstPersonNode.getNodeType() == Node.ELEMENT NODE)( 
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Element firstPersonElement = (Element)firstPersonNode; 
NodeList firstNameList = 

firstPersonElement.getElementsByTagNamer("first"); 

Element firstNameElement 
= (Element)firstNameList.item(0); 
NodeList textFNList = firstNameElement.getChildNodes(); 
System.out.printin("First Name : " + 
((Node)textFNList.item(0)).getNodeValue().trim()); 
NodeList lastNameList 
= firstPersonElement.getElementsByTagName("last"); 
Element lastNameElement = (Element)lastNameList.item(0); 
NodeList textL NList  lastNameElement.getChildNodes(); 
System.out.printin("Last Name : " + 
((Node)textLNList.item(0)).getNodeValue().trim()); 

NodeList ageList 

= firstPersonElement.getElementsByTagName("age"); 
Element ageElement = (Element)ageList.item(0); 
NodeList textAgeList = ageElement.getChildNodes(); 
System.out.printin("Age : "+ 

((Node)textAgeList.item(0)).getNodeValue().trim()); 


catch (SAXParseException err) 
{ 
System.out.printin ("** Parsing error" + ", line " 
+ err.getLineNumber () * ", uri " + err.getSystemld ()); 
System.out.printIn(" " + err.getMessage (); } 
catch (SAXException e) ( 
Exception x = e.getException (); 
((х == null) ? e : x).printStackTrace (); 
} 
catch (Throwable t) { 
t.printStackTrace (); 
) 
) 
) 


户 在 Java API 中 还 可 以 找到 更 多 操作 XML 文档 的 方法 ， 执 行 上 述 代码 后 得 到 如 图 3-9 所 示 的 结果 。 


注意 : XML 文档 其 实 比 HTML 文档 更 简单 ，XML 主要 用 来 存储 信息 ， 不 负责 显示 在 页 面 。 获 取 XML 
文档 的 方法 有 很 多 ， 也 并 不 是 只 有 Java 语言 ， 还 有 许多 语言 都 可 以 调用 ， 如 CH. PHP 和 ASP 
等 ， 也 包括 HTML 语言 。 


Ë 问题 @ Jevadoc | E 控制 台 X ax Bele г 3 
JEFE) ReadAndPrintKWLFile [Java 应 用 程序 ] C:\Program Files\Java\jre6\bin\javer. exe ( 2009-2-19 
Root element of the doc is book 

Total no of people : 3 

First Name : Kiran 


First Name : Steve 
Last Name : Jobs 
Age : 40 


图 3-9 获取 XML 文档 
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3.5.4 SAX 常用 的 接口 和 类 


SAX, 全 称 Simple API for XML, 既是 一 种 接口 , 也 是 一 个 软件 包 。 SAX 最 初 是 由 David Megginson 
采用 Java 语言 开发 的 ， 之 后 SAX 很 快 在 Java 开发 者 中 流行 起 来 。San 现在 负责 管理 其 原始 API 的 开 
发 工作 ， 这 是 一 种 公开 的 、 开 放 源 代 码 的 软件 。 不 同 于 其 他 大 多 数 XML 标准 的 是 ，SAX 没有 语言 开 
发 商 必须 遵守 的 标准 SAX 参考 版 本 。 因 此 ，SAX 的 不 同 实现 可 能 采用 区 别 很 大 的 接口 。 

在 现实 开发 应 用 中 ，SAX 将 其 事件 分 为 如 下 所 示 的 接口 。 

M ContentHandler: 定义 与 文档 本 身 关联 的 事件 (例如 ， 开 始 和 结束 标记 )。 大 多 数 应 用 程序 都 

注册 这 些 事 件 。 

DTDHandler: 定义 与 DTD 关联 的 事件 。 然 而 ， 它 不 定义 足够 的 事件 来 完整 地 报告 DTD。 如 

果 需 要 对 DTD 进行 语法 分 析 , 请 使 用 可 选 的 DeclHandler。DeclHandler 是 SAX 的 扩展 , ЗЕН. 
不 是 所 有 的 语法 分 析 器 都 支持 它 。 

EntityResolver: 定义 与 装 入 实体 关联 的 事件 。 只 有 少数 几 个 应 用 程序 注册 这 些 事件 。 

ErrorHandler: 定义 错误 事件 。 许 多 应 用 程序 注册 这 些 事件 以 便 用 它们 自己 的 方式 报错 。 

为 简化 工作 ，SAX 在 DefaultHandler 类 中 提供 了 这 些 接口 的 默认 实现 。 在 大 多 数 情况 下 ， 为 应 用 
程序 扩展 DefaultHandler 并 覆盖 相关 的 方法 要 比 直接 实现 一 个 接口 更 容易 。 


1. XMLReader 


如 果 为 注册 事件 处 理 器 并 启动 语法 分 析 器 ， 应 用 程序 应 该 使 用 XMLReader 接口 ,实现 方法 是 使 
XMLReader 中 的 parse0 方 法 来 启动 ， 具 体 语 法 格式 如 下 : 

parser.parse(args[0]); 

XMLReader 中 的 主要 方法 如 下 。 

рагѕе(): 对 XML 文档 进行 语法 分 析 。parse0 有 两 个 版 本 : 一 个 接收 文件 名 或 URL， 另 一 个 接 
收 InputSource 对 象 。 

setContentHandler(), setDTDHandler(), setEntityResolver() il setErrorHandler0: 让 应 用 程序 注 
册 事 件 处 理 器 。 

setFeature() 和 setProperty(): 控制 语法 分 析 器 如 何 工 作 。 它 们 采用 一 个 特性 或 功能 标识 一 个 
类 似 于 名 称 空 间 的 URI 和 值 )。 功 能 采用 Boolean 值 ， 而 特性 采用 “对 象 ”。 

最 常用 的 XMLReaderFactory 功能 如 下 所 示 。 

http://xml.org/sax/features/namespaces: 所 有 SAX 语法 分 析 器 都 能 识别 它 。 如 果 将 它 设置 为 true 

(默认 值 )， 则 在 调用 ContentHandler 的 方法 时 ， 语 法 分 析 器 将 识别 出 名 称 空间 并 解析 前 级 。 

http://xml.org/sax/features/validation: 它 是 可 选 的 。 如 果 将 它 设 置 为 tue， 则 验证 语法 分 析 器 将 

验证 该 文档 。 非 验证 语法 分 析 器 忽略 该 功能 。 


2. XMLReaderFactory 


XMLReaderFactory 用 于 创建 语法 分 析 器 对 象 ， 它 定义 了 createXMLReader0 的 如 下 两 个 版 本 。 

M ”一 个 采用 语法 分 析 器 的 类 名 作为 参数 。 

一 个 从 org.xml.sax.driver 系统 特性 中 获得 类 名 称 。 

对 于 Xerces， 类 是 org.apache.xerces.parsers.SAXParser。 应 该 使 用 XMLReaderFactory， 因 为 它 易于 


e. 


切换 至 另 一 种 SAX 语法 分 析 器 。 实 际 上 ， 只 需要 更 改 一 行 然后 重新 编译 。 
XMLReaderparser=XMLReaderFactory.createXMLReader( 
"org.apache.xerces.parsers.SAXParser"); 


为 获得 更 大 的 灵活 性 ， 应 用 程序 可 以 从 命令 行 读 取 类 名 或 使 用 不 带 参数 的 createXMLReaderO. D 
此 可 以 不 重新 编译 就 更 改 语法 分 析 器 。 


3. InputSource 


InputSource 控制 语法 分 析 器 如 何 读 取 文件 ， 包 括 XML 文档 和 实体 。 在 大 多 数 情况 下 ， 文 档 是 从 
URL 装 入 的 。 但 有 特殊 需求 的 应 用 程序 可 以 覆盖 InputSource。 例如 , 这 可 以 用 来 从 数据 库 中 装 入 文档 。 


4. ContentHandler 


ContentHandler 是 最 常用 的 SAX 接口 , 因为 它 定义 XML 文档 的 事件 。 在 ContentHandler 中 声明 了 
如 下 所 示 的 事件 。 

(1) startDocument()/endDocument(): 通知 应 用 程序 文档 的 开始 或 结束 。 

(2) startElement()'endElement(): 通知 应 用 程序 标记 的 开始 或 结束 。 属 性 作为 Attributes 参数 传递 。 
即使 只 有 一 个 标记 ,“ 空 ”元 素 ( 例 如 ，<imghre 伍 "logo.gif'/>) 也 生成 startElement( fll endElement()。 

(3) startPrefixMapping()/endPrefixMapping(): 通知 应 用 程序 名 称 空间 作用 域 。 几 乎 不 需要 该 信息 ， 
因为 当 http://xml.org/sax/features/namespaces 为 tue 时 ， 语 法 分 析 器 已 经 解析 了 名 称 空间 。 

(4) 当 语法 分 析 器 在 元 素 中 发 现 文本 〈 已 经 过 语法 分 析 的 字符 数据 ) PP, charactersO/ignorable 
Whitespace0 会 通知 应 用 程序 。 要 知道 , 语法 分 析 器 负责 将 文本 分 配 到 几 个 事件 (更 好 地 管理 其 缓冲 区 )。 
ignorableWhitespace 事件 用 于 由 XML 标准 定义 的 可 忽略 空格 。 

(5) processingInstruction0: 将 处 理 指令 通知 应 用 程序 。 

(6) skippedEntityO: 通知 应 用 程序 已 经 跳 过 了 一 个 实体 〈 即 当 语 法 分 析 器 未 在 DTD/schema 中 发 
现实 体 声明 时 )。 

(7) setDocumentLocator(): 将 Locator 对 象 传递 到 应 用 程序 ; 请 注意 ， 不 需要 SAX 语法 分 析 器 提 
供 Locator， 但 是 如 果 它 提供 了 ， 则 必须 在 任何 其 他 事件 之 前 激活 该 事件 。 

5. 属性 

在 startElement(0 事 件 中 ， 应 用 程序 在 Attributes 参数 中 接收 属性 列表 。 

Stringattribute=attributes.getValue("","price"); 

Attributes 定义 下 列 方法 。 
getValue(i)/getValue(qName)/getValue(uri,localName): 返回 第 i 个 属性 值 或 给 定名 称 的 属性 值 。 
getLength(): 返回 属性 数目 。 
getQName(i)/getLocalName(i)/getURI(i): 返回 限定 名 带 前 级 )、 本 地 名 (不 带 前 级 ) 和 第 i 
个 属性 的 名 称 空间 URI. 
getType(iy/getType(qName)/getType(urilocalName): 返回 第 i 个 属性 的 类 型 或 者 给 定名 称 的 属 
性 类 型 。 类 型 为 字符 串 ， 即 在 DTD 所 使 用 的 CDATA, ID. IDREF. IDREFS. NMTOKEN, 
NMTOKENS, ENTITY, ENTITIES 或 NOTATION。 


Е: Attributes 参数 仅 在 startElementO 事 件 期 间 可 用 。 如 果 在 事件 之 间 需 要 它 ， 则 用 AttributesImpl 


复制 一 个 。 
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6. 定位 器 
Locator 为 应 用 程序 提供 行 和 列 的 位 置 。 不 需要 语法 分 析 器 来 提供 Locator 对 象 。Locator 定义 下 列 
Jn. 
getColumnNumber(): 返回 当前 事件 结束 时 所 在 的 那 一 列 。 在 endElement0 事 件 中 ， 它 将 返回 
结束 标记 所 在 的 最 后 一 列 。 
getLineNumber(): 返回 当前 事件 结束 时 所 在 的 行 。 在 endElement0 事 件 中 , 它 将 返回 结束 标记 
所 在 的 行 。 
getPublicld(): 返回 当前 文档 事件 的 公共 标识 。 
getSystemId(: 返回 当前 文档 事件 的 系统 标识 。 
DTDHandler 


DTDHandler 声明 两 个 与 DTD 语法 分 析 器 相关 的 事件 ， 具 体 如 下 所 示 。 

notationDecl(): 通知 应 用 程序 已 经 声明 了 一 个 标记 。 

nparsedEntityDecl(): 通知 应 用 程序 已 经 发 现 了 一 个 未 经 过 语法 分 析 的 实体 声明 。 

8. EntityResolver 

EntityResolver 接口 仅 定 义 一 个 事件 resolveEntity0， 它 返回 InputSource。 因 为 SAX 语法 分 析 器 已 
经 可 以 解析 大 多 数 URL， 所 以 很 少 应 用 程序 实现 EntityResolver。 例 外 情况 是 目录 文件 ， 它 将 公共 标识 
解析 成 系统 标识 。 如 果 在 应 用 程序 中 需要 目录 文件 ， 请 下 载 NormanWalsh 的 目录 软件 包 〈 请 参阅 参考 
资料 )。 

9. ErrorHandler 

ErrorHandler 接口 定义 错误 事件 。 处 理 这 些 事件 的 应 用 程序 可 以 提供 定制 错误 处 理 。 安 装 了 定制 错 
误 处 理 器 后 ， 语 法 分 析 器 不 再 抛 出 异常 。 抛 出 异常 是 事件 处 理 器 的 责任 。 接 口 定 义 了 错误 的 3 个 级 别 
或 严重 性 对 应 的 3 个 方法 。 

waring): 警示 那些 不 是 由 XML 规范 定义 的 错误 。 例 如 ， 当 没有 XML 声明 时 ， 某 些 语法 分 

析 器 发 出 警告 。 它 不 是 错误 (因为 声明 是 可 选 的 )， 但 是 它 可 能 值得 注意 。 

М eror): 警示 那些 由 XML 规范 定义 的 错误 。 

fatalError(): 警示 那些 由 XML 规范 定义 的 致命 错误 。 

10. SAXException 

SAX 定义 的 大 多 数 方法 都 可 以 抛 出 SAXException。 当 对 XML 文档 进行 语法 分 析 时 , SAXException 
会 抛 出 一 个 错误 ， 这 里 的 错误 可 以 是 语法 分 析 错 误 ， 也 可 以 是 事件 处 理 器 中 的 错误 要 报告 来 自 事件 处 
理 器 的 其 他 异常 ， 可 以 将 异常 封装 在 SAXException 中 。 


3.5.5 ”实战 演练 一 一 使 用 SAX 解析 XML 数据 


Android 是 最 常用 的 智能 手机 平台 ，XML 是 数据 交换 的 标准 媒介 。 在 Android 系统 中 可 以 使 用 标 
准 的 XML 生成 器 、 解 析 器 、 转 换 器 API， 对 XML 进行 解析 和 转换 。 本 实例 的 功能 是 在 物 联 网 中 使 用 
SAX 解析 XML 数据 。 


® 
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第 3 章 基本 数据 通信 


(1) 编写 布局 文件 main.xml， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-" vertical" > 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


</LinearLayout> 
(20 解析 功能 的 核心 文件 是 SAXForHandlerjava， 主 要 实现 代码 如 下 : 
public class SAXForHandler extends DefaultHandler{ 
private static final String TAG = "SAXForHandler"; 
private List<Person> persons; 
private String perTag ;// 通 过 此 变量 ， 记 录 前 一 个 标签 的 名 称 
Person person;// 记 录 当 前 Person 


public List<Person> getPersons() { 
return persons; 


} 


// 适 合 在 此 事件 中 触发 初始 化 行为 

public void startDocument() throws SAXException { 
persons = new ArrayList<Person>(); 
Log.i(TAG , "***startDocument()***"); 

) 


public void startElement(String uri, String localName, String qName, 
Attributes attributes) throws SAXException { 
if("person".equals(localName)){ 
for ( int i = 0; i < attributes.getLength(); i++ ) { 
Log.i(TAG ,"attributeName:" + attributes.getLocalName(i) 
*" attribute Value:" + attributes.getValue(i)); 
person = new Person(); 
person.setld(Integer.valueOf(attributes.getValue(i))); 
} 
} 
perTag = localName; 
Log.i(TAG , qName+"***startElement()***"); 
} 


public void characters(char[] ch, int start, int length) throws SAXException { 
String data = new String(ch, start, length).trim(); 
if(!"".equals(data.trim())){ 
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Log.i(TAG ,"content: " + data.trim()); 
} 
if("name".equals(perTag)){ 
person.setName(data); 
}else if("age".equals(perTag)){ 
person.setAge(new Short(data)); 
} 
} 


public void endElement(String uri, String localName, String qName) 
throws SAXException { 
Log.i(TAG , gName+"***endElement()***"); 
if("person".equals(localName)){ 
persons.add(person); 
person - null; 


perTag = null; 


} 


public void endDocument() throws SAXException { 
Log.i(TAG , "***endDocument()***"); 
} 
} 
(3) 单元 测试 文件 PersonServiceTest.java 的 具体 代码 如 下 : 
public void testSAXGetPersons() throws Throwable{ 
InputStream inputStream = this.getClass().getClassLoader(). 
getResourceAsStream("wang.xml"); 
SAXForHandler saxForHandler = new SAXForHandler(); 
SAXParserFactory spf = SAXParserFactory.newinstance(); 
SAXParser saxParser = spf.newSAXParser(); 
saxParser.parse(inputStream, saxForHandler); 
List<Person> persons = saxForHandler.getPersons(); 
inputStream.close(); 
for(Person person:persons){ 
Log.i(TAG, person.toString()); 
) 


} 
此 时 使 用 Eclipse 启动 Android 模拟 器 ， 执 行 后 的 效果 如 图 3-10 所 示 。 


| xML_Parser 


图 3-10 ”执行 效果 


(4) 开 始 具 体 测试 , 在 Eclipse 中 导入 本 实例 项 目 ,在 Outline 面板 中 右 击 testSAXGetPersons():void, 
如 图 3-11 所 示 ， 在 弹出 的 快捷 菜单 中 选择 Run As | Android JUnit Test 命令 ， 如 图 3-12 所 示 。 
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3-11 右 击 testSAXGetPersons:void 图 3-12 选择 Android JUnit Test 命令 
此 时 将 在 Logcat 中 显示 测试 的 解析 结果 ， 如 图 3-13 所 示 。 


(0, Declaration [ZJ Console XD LogCat 11 ^+ 
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AndroidRuntime Shutting down УМ 


3-13 ”解析 结果 


注意 :如 果 Android 下 的 Eclipse 界面 中 没有 Logcat 面板 ,只 需 依 次 选择 Eclipse 菜单 栏 中 的 Window | show 
view | other | Android 命令 ， 然 后 选择 Logcat 后 即 可 在 Eclipse 界面 看 到 Logcat 面板 。 


356 ”实战 演练 一 一 使 用 DOM 解析 XML 数据 


DOM 是 Document Object Model 的 简称 , 被 译 为 文件 对 象 模型 ,是 W3C 组 织 推荐 的 处 理 可 扩展 置 
标语 言 的 标准 编程 接口 。 Document Object Model 的 历史 可 以 追溯 至 20 世纪 90 年 代 后 期 微软 与 Netscape 
的 “浏览 器 大 战 ”， 双 方 为 了 在 JavaScript 与 Jscript 间 一 决 生死 ， 于 是 大 规模 地 赋予 浏览 器 强大 的 功能 。 
微软 在 网 页 技术 上 加 入 了 不 少 专属 事物 , BA VBScript. ActiveX 以 及 微软 的 DHTML 格式 等 ， 使 不 少 
网 页 使 用 非 微软 平台 及 浏览 器 无 法 正常 显示 . 本 实例 将 演示 在 Android 物 联网 中 使 用 DOM 技术 来 解析 
并 生成 XML 的 方法 。 


а а H 的 源码 路 径 
-实例 3-10 | 在 物 联网 中 使 用 DOM 解析 XML 数据 _ 光盘 :\daima3WXMLI PamerEX — C 
本 实例 的 具体 实现 流程 如 下 。 


(1) 编写 布局 文件 main.xml， 具 体 实 现代 码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
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android:orientation-" vertical" > 

«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 


</LinearLayout> 
(2) 编写 解析 功能 的 核心 文件 DOMPersonService.java， 具 体 实现 流程 如 下 : 
М ”创建 DocumentBuilderFactory 对 象 factory， 并 调用 newInstanceO 创 建新 实例 。 
创建 DocumentBuilder 对 象 builder, DocumentBuilder 将 实现 具体 的 解析 工作 以 创建 Document 
对 象 。 
解析 目标 XML 文件 以 创建 Document 对 象 。 
文件 DOMPersonService java 的 具体 实现 代码 如 下 : 
public class DOMPersonService { 
public static List<Person> getPersons(InputStream inStream) throws Exception{ 
List<Person> persons = new ArrayList<Person>(); 
DocumentBuilderFactory factory = DocumentBuilderFactory.newinstance(); 
DocumentBuilder builder = factory.newDocumentBuilder(); 
Document document = builder.parse(inStream); 
Element root = document.getDocumentElement(); 
NodeList personNodes = root.getElementsByTagName("person"); 
for(int i=0; i < personNodes.getLength() ; i++){ 
Element personElement = (Element)personNodes.item(i); 
int id = new Integer(personElement.getAttribute("id")); 
Person person = new Person(); 
person.setld(id); 
NodeList childNodes = personElement.getChildNodes(); 
for(int у=0; y < childNodes.getLength() ; у++){ 
if(childNodes.item(y).getNodeType()==Node.ELEMENT_NODE){ 
if("name".equals(childNodes.item(y).getNodeName())){ 
String name = childNodes.item(y).getFirstChild().getNodeValue(); 
person.setName(name); 
}else if("age" equals(childNodes.item(y).getNodeName()))( 
String age = childNodes.item(y).getFirstChild().getNodeValue(); 
person.setAge(new Short(age)); 


} 
} 
persons.add(person); 
} 
inStream.close(); 
return persons; 
} 
} 
(3) 编写 单元 测试 文件 PersonServiceTestjava， 具 体 代码 如 下 : 
public void testDOMgetPersons() throws Throwable{ 
InputStream inStream = this.getClass().getClassLoader(). 
getResourceAsStream("wang.xml"); 
List<Person> persons = DOMPersonService.getPersons(inStream); 
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for(Person person : persons){ 
Log.i(TAG, person.toString()); 


} 
} 


(4) 开 始 具体 测试 ,在 Eclipse 中 导入 本 实例 项 目 ,在 Outline 面板 中 右 击 testDOMgetPersons():void, 
如 图 3-14 所 示 ， 在 弹出 的 快捷 菜单 中 选择 Run As | Android JUnit Test 命令 ， 如 图 3-15 所 示 。 


aed Open Type Hierarchy 
ae Call неъ 
:Classtoader() ms x 
stPersens instream); D 
decer 
Cory nidi fied Nane 
T Paste 
ible Nass 
_ ‘Classtoader() .getResource 
ВЕ Outine 3| EIR Ow TOO а Т ostream: ap EB 
HB сов. xml x 
ERO PersonServi н 
ФЕ TG 
© testSAXGetP 


图 3-14 


testPullgetPersons 0 4 
testSave 0 


右 击 testDOMgetPersons():void 


图 3-15 选择 Android JUnit Test 命令 
此 时 将 在 Logcat 中 显示 测试 的 解析 结果 ， 如 图 3-16 所 示 。 
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3-16 ”解析 结果 
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第 4 章 蓝牙 技术 详解 


蓝牙 这 一 名 称 来 自 于 10 世纪 的 一 位 丹麦 国王 Harald Blatand，Blatand 在 英文 里 的 意思 可 以 被 解释 
为 Bluetooth。 因 为 国王 喜欢 吃 蓝莓 ， 牙 齿 每 天 都 是 蓝 色 的 所 以 叫 蓝牙 。 蓝 牙 的 创始 人 是 瑞典 爱立信 公 
司 ， 爱 立信 早 在 1994 年 就 已 进行 研发 。1997 年 ， 爱 立信 和 与 其 他 设备 生产 商 联 系 ， 并 激发 了 他 们 对 该 项 
技术 的 浓厚 兴趣 。1998 年 2 月 ，5 个 跨国 大 公司 ， 包 括 爱 立信 、 诺 基 亚 、IBM、 东 芝 及 Intel 组 成 了 一 
个 特殊 兴趣 小 组 (SIG)， 他 们 共同 的 目标 是 建立 一 个 全 球 性 的 小 范围 无 线 通信 技术 ， 也 就 是 现在 的 蓝 
F. Œ Android 设备 中 ， 蓝 牙 技术 是 常用 的 一 种 近 距 离 数 据 传输 技术 。 本 章 将 详细 讲解 蓝牙 技术 的 基 
本 知识 。 
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在 物 联网 中 物 与 网 相连 的 最 后 数 米 ， 发 挥 关键 作用 的 是 短 距离 无 线 传输 技术 。 目 前 有 多 种 短 距离 
无 线 传输 技术 可 以 应 用 在 物 联 网 中 , ERE, 除 已 经 得 到 大 规模 应 用 的 RFID. 之 外 , 还 有 WiFi. ZigBee. 
蓝牙 等 比较 成 熟 的 技术 ， 以 及 基于 这 些 技术 发 展 而 来 的 新 技术 。 这 些 技术 各 具 特 点 ， 因 对 其 传输 速度 、 
距离 、 耗 电量 等 方面 的 要 求 不 同 ， 形 成 了 各 自 不 同 的 物 联网 应 用 场景 。 本 节 将 简要 介绍 当今 实现 短 距 
离 无 线 通信 的 常用 技术 。 


4.1.1 ZigBee 一 一 低 功 耗 、 自 组 网 


ZigBee 以 其 鲜明 的 技术 特点 在 物 联网 中 受到 了 高 度 关注 ， 该 技术 使 用 的 频段 分 别 为 2.4GHz、 
868MHz〔 欧 洲 ) 及 915MHz (美国 )。 其 主要 的 技术 特点 如 下 : 一 是 数据 传输 速率 低 ， 只 有 10Kbps 一 
250Kbps; 二 是 功 耗 低 ， 低 传输 速率 带 来 了 仅 为 1 毫 瓦 的 低 发 射 功率 。 据 估算 ，ZigBee 设备 仅 靠 两 节 5 
号 电池 就 可 以 维持 长 达 6 个 月 到 两 年 左右 的 使 用 时 间 ， 这 是 ZigBee 的 一 个 独特 优势 ， 三 是 成 本 低 ， 因 
为 ZigBee 传输 速率 低 、 协 议 简单 ， 四 是 网 络 容量 大 ， 每 个 ZigBee 网 络 最 多 可 以 支持 255 个 设备 ， 一 
个 区 域内 可 以 同时 存在 最 多 100 个 ZigBee 网 络 ， 网 络 组 成 灵活 。ZigBee 芯片 的 主要 企业 有 德州 仪器 、 
飞 思 卡 尔 等 。 市 场 调研 机 构 ABI Research 的 一 份 数据 显示 ，2005 一 2012 年 ，ZigBee 市 场 的 年 均 复合 增 
长 率 为 63%。 

“ZigBee 是 从 家 庭 自动 化 开始 的 ， 在 瑞典 哥德堡 就 是 从 智能 电表 开始 ， 然 后 进一步 用 到 燃气 表 、 
水 表 、 热 力 表 等 家 庭 各 种 计量 表 。” 在 2011 年 中 国 无 线 世界 暨 物 联网 大 会 上 ZigBee 联盟 大 中 华 区 代表 
黄 家 瑞 说 :“ZigBee 在 智能 电表 里 不 仅仅 是 远程 抄 表 工 具 ， 它 是 一 个 终端 ， 也 是 一 个 网 关 ， 这 些 网 关 结 
合 在 一 起 ， 整 个 小 区 就 变 成 了 智能 电网 小 区 ， 智 能 电表 可 以 搜集 家 里 所 有 家 电 的 用 电信 息 。” 

目前 ，ZigBee 正在 完善 其 网 关 标 准 ，2011 年 7 月 底 发 布 了 第 10 个 标准 ZigBee Gateway (ZigBee 


вав manage 000 


PIS). ZigBee Gateway 提供 了 一 种 简单 、 高 成 本 效益 的 互联 网 连接 方式 ， 使 服务 提供 商 、 企 业 和 个 人 
消费 者 有 机 会 运行 这 些 设备 并 将 ZigBee 网 络 连接 至 互联 网 .ZigBee Gateway 是 ZigBee Network Devices 
(ZigBee 网 络 设备 ) 这 一 新 类 别 范畴 的 首 个 标准 ， 这 将 使 ZigBee 发 展 进一步 提速 。 


4.1.2 ”WiFi 一 一 大 带宽 支持 家 庭 互 联 


WiFi 是 以 太 网 的 一 种 无 线 扩展 技术 ， 如 果 有 多 个 用 户 同时 通过 一 个 热点 接 入 ， 带 宽 将 被 这 些 用 户 
共享 ，WiFi 的 速率 会 降低 ， 处 于 2.4GHz 频段 的 WiFi 信号 受 墙壁 阻隔 的 影响 较 小 。WiFi 的 传输 速率 
随 着 技术 的 演进 还 在 不 断 提高 ， 我 国电 信 运 营 商 在 构建 无 线 城市 中 采用 的 WiFi 技术 部 分 已 经 升级 到 
802.11n， 最 高 速率 从 802.11g 标准 的 11Mbps 提高 到 50Mbps 以 上 。 在 WiFi 产业 链 中 ， 最 大 的 芯片 企 
业 是 博通 。 

“在 过 去 几 年 里 整个 WiFi 技术 和 产品 发 货 量 达到 20 亿 个 , 整个 WiFi 产品 销售 每 年 都 是 以 两 位 数 
的 速度 持续 增长 ”WiFi 联盟 董事 Myron Hattig H: “E 2011 年 我 们 还 会 销售 10 亿 个 产品 。” 

在 笔记 本 电脑 和 手机 上 已 经 得 到 广泛 应 用 的 WiFi 正在 向 消费 电子 产品 渗透 , Myron Hattig 说 :“ 除 
了 手机 外 ,已经 有 25% 的 消费 类 电子 设备 使 用 WiFi， 在 打印 机 、 洗 衣 机 上 都 在 使 用 WiFi， 家 用 电器 生 
产 商 协会 将 WiFi 作为 一 个 更 高 级 别 的 智能 电器 沟通 技术 。WiFi 可 以 将 设备 与 设备 相连 ， 从 而 使 整个 
家 庭 的 家 用 电器 、 电 子 设备 相连 。” 

最 大 WiFi 芯片 制造 商 博通 正在 推动 WiFi Direct 标准 的 商用 ， 以 支持 这 种 设备 到 设备 的 直 连 。 特 
别 是 在 家 庭 互联 中 ， 相 片 、 视 频 等 大 数据 量 的 业务 在 手机 、 平 板 电脑 、 电 视 等 设备 中 的 直 连 应 用 前 
景 广阔 。Myron Наша 告诉 记者 :“ 直 连 技术 可 将 平板 电脑 的 内 容 展 示 在 电视 上 ， 相 关 产 品 会 在 2012 
ERM o” 

基于 WiFi 上 发 展 起 来 的 WIGIG 也 是 未 来 家 庭 互 联 市 场 有 力 的 竞争 技术 。 该 技术 可 工作 在 40GHz— 
60GHz 的 超 高 频段 ， 其 传输 速度 可 以 达到 1Gbps 以 上 ， 不 能 穿 过 墙壁 。 目 前 英特尔 、 高 通 等 芯片 企业 
在 支持 WIGIG 发 展 ， 该 技术 还 在 完善 中 ， 如 需要 进一步 降低 功 耗 等 。 


4.1.3 ”蓝牙 一 一 4.0 进入 低 功 耗 时 代 


使 用 “蓝牙 ”技术 可 以 有 效 地 简化 移动 通信 终端 设备 之 间 的 通信 ， 也 能 够 成 功 地 简化 设备 与 互联 
网 之 间 的 通信 ， 从 而 使 数据 传输 变 得 更 加 迅速 高 效 ， 为 无 线 通信 拓宽 道路 。 蓝 牙 采 用 分 散 式 网 络 结构 
以 及 快 跳 频 和 短 包 技术 ,支持 点 对 点 及 点 对 多 点 通信 , 工作 在 全 球 通用 的 2.4GHz ISM ( 即 工业 、 科 学 、 
医学 ) 频段 。 蓝 牙 技 术 的 数据 传输 速率 为 IMbps， 采 用 时 分 双 工 传输 方案 实现 全 双 工 传输 。 

蓝牙 是 一 种 Bluetooth 传输 无 线 技术 ， 许 多 行业 的 制造 商都 积极 地 在 其 产品 中 实施 此 技术 ， 以 减少 
使 用 零乱 的 电线 ， 实 现 无 颖 连接 、 流 传输 立体 声 ， 传 输 数据 或 进行 语音 通信 。Bluetooth 技术 在 2.4GHz 
波段 运行 ， 该 波段 是 一 种 无 须 申 请 许可 证 的 工业 、 科 技 、 医 学 (ISM) 无 线 电 波段 。 正 因 如 此 ， 使 用 
Bluetooth 技术 不 需要 支付 任何 费用 。 但 必须 向 手机 提供 商 注 册 使 用 GSM 或 CDMA, 除了 设备 费用 外 ， 
不 需要 为 使 用 Bluetooth 技术 再 支付 任何 费用 。 

Bluetooth 技术 得 到 了 空前 广泛 的 应 用 ， 集 成 该 技术 的 产品 从 手机 、 汽 车 到 医疗 设备 ， 使 用 该 技术 
的 用 户 从 消费 者 、 工 业 市 场 到 企业 等 ， 不 一 而 足 。 低 功 耗 、 小 体积 以 及 低 成 本 的 芯片 解决 方案 使 得 
Bluetooth 技术 甚至 可 以 应 用 于 极 微小 的 设备 中 。 


Быел 


Bluetooth 技术 是 一 项 即时 技术 ， 它 不 要 求 固定 的 基础 设施 ， 且 易于 安装 和 设置 ， 不 需要 电缆 即 可 
实现 连接 。 新 用 户 使 用 亦 不 费力 ， 只 需 拥有 Bluetooth 品牌 产品 ， 检 查 可 用 的 配置 文件 ， 将 其 连接 至 使 
用 同一 配置 文件 的 另 一 Bluetooth 设备 即 可 。 后 续 的 PIN 码 流程 就 如 同 用 户 在 ATM 机 器 上 操作 一 样 简 
单 。 外 出 时 ， 可 以 随身 带 上 用 户 的 个 人 局 域 网 (PAN)， 甚 至 可 以 与 其 他 网 络 连 接 。 

蓝牙 可 以 在 包括 移动 电话 、PDA、 无 线 耳 机 、 笔 记 本 电脑 、 相 关外 设 等 众多 设备 之 间 进 行 无 线 信 
息 交 换 。 蓝 牙 采 用 分 散 式 网 络 结构 以 及 快 跳 频 和 短 包 技术 ， 支 持 点 对 点 及 点 对 多 点 通信 ， 工 作 在 全 球 
通用 的 2.4GHz 频段 ， 其 数据 速率 为 1Mbps。 

2010 年 7 月 ， 以 低 功 耗 为 特点 的 蓝牙 4.0 标准 推出 ， 蓝 牙 大 中 华 区 技术 市 场 经 理 吕 荣 良 将 其 看 作 
蓝牙 第 二 波 发 展 高 潮 的 标志 ， 他 表示 :“ 蓝 牙 可 以 跨 领域 应 用 ， 主 要 有 4 个 生态 系统 ， 分 别 是 智能 手机 
与 笔记 本 电脑 等 终端 市 场 、 消 费 电 子 市 场 、 汽 车 前 装 市 场 和 健身 运动 器 材 市 场 。” 

NEC 和 UWB 曾经 是 十 分 受 关注 的 短 距离 无 线 接 入 技术 , 但 其 发 展 已 经 日 渐 势 微 。 业内 专家 认为 ， 
无 线 频谱 的 规划 和 利用 在 短 距离 通信 中 日 益 重 要 。 短 距离 通信 技术 目前 主要 采用 2.4GHz 的 开放 频谱 ， 
但 随 着 物 联 网 的 发 展 和 大 量 短 距离 通信 技术 的 应 用 ， 频 谱 需 求 会 快速 增长 ， 视 频 、 图 像 等 大 数据 量 的 
通信 正在 寻求 更 高 频段 的 解决 方案 。 


414 ”NFC 一 一 必 将 逐渐 远离 历史 舞台 


NFC 是 近 场 通信 (Near Field Communication) 的 缩写 ， 此 技术 由 非 接触 式 射 频 识 别 (RFID) 演变 
而 来 ， 由 飞利浦 半导体 ( 现 恩 智 浦 半导体 )、 诺 基 亚 和 索尼 共同 研制 开发 ， 其 基础 是 RFID 及 互 连 技术 。 
NEC 是 一 种 短 距 高 频 的 无 线 电 技术 ， 在 13.56MHz 频率 运行 于 20 厘米 距离 内 。 其 传输 速度 有 106Kbit/ 
秒 、212Kbit/ 秒 或 者 424Kbit/ 秒 3 种 。 目 前 近 场 通信 已 通 过 成 为 ISO/ITEC IS 18092 国际 标准 、ECMA-340 
标准 与 ETSI TS 102 190 标准 。NFC 采用 主动 和 被 动 两 种 读 取 模式 。 

NFC 近 场 通信 技术 是 由 非 接触 式 射频 识别 (RFID) 及 互联 互通 技术 整合 演变 而 来 的 ， 在 单一 芯片 
上 结合 感应 式 读 卡 器 、 感 应 式 卡 片 和 点 对 点 的 功能 ， 能 在 短 距离 内 与 兼容 设备 进行 识别 和 数据 交换 。 
工作 频率 为 13.56MHz, 但 是 使 用 这 种 手机 支付 方案 的 用 户 必须 更 换 特制 的 手机 。 目 前 这 项 技术 在 日 韩 
被 广泛 应 用 。 手 机 用 户 任 着 配置 了 支付 功能 的 手机 就 可 以 行 遍 全 国 : 他 们 的 手机 可 以 用 作 机 场 登 机 验 
证 、 大 厦 的 门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 、 支 付 卡 等 。 

NFC 和 蓝牙 (Bluetooth) 都 是 短程 通信 技术 ， 而 且 都 被 集成 到 移动 电话 。 但 NEC 不 需要 复杂 的 设 
置 程序 。NFC 也 可 以 简化 蓝牙 连接 。NFC 略 胜 蓝牙 的 地 方 在 于 设置 程序 较 短 ， 但 无 法 达到 低 功率 蓝牙 

(Bluetooth Low Energy) 的 速度 。 在 两 台 NFC 设备 相互 连接 的 设备 识别 过 程 中 ， 使 用 NFC 来 替代 人 
工 设 置 会 使 创建 连接 的 速度 大 大 加 快 ， 会 少 于 十 分 之 一 秒 。 


42 低 功 耗 蓝牙 基础 
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BLE 是 Bluetooth Low Energy 的 缩写 ， 意 为 低 功 耗 蓝牙 ， 是 对 传统 蓝牙 BR/EDR 技术 的 补充 。 尽 
管 BLE 和 传统 蓝牙 都 被 称 为 蓝牙 标准 ， 并 且 都 共享 射频 ， 但 BLE 是 一 个 完全 不 一 样 的 技术 。BLE 不 
具备 和 传统 蓝牙 BR/EDR 的 兼容 性 ， 是 专 为 小 数据 率 、 离 散 传输 的 应 用 而 设计 的 。 本 节 将 详细 讲解 低 


® 


зле ияижиш ООП 
功 耗 蓝牙 技术 的 基本 知识 。 
421 低 功 耗 蓝 牙 的 架构 


BLE 协议 架构 总 体 上 分 成 3 层 , 从 下 到 上 分 别 是 控制 器 (Controller)、 主 机 (Host) 和 应 用 端 ( Apps)。 
三 者 可 以 在 同一 芯片 内 实现 ， 也 可 以 分 不 同 芯 片 实现 ， 控 制 器 (Controller) 是 处 理 射频 数据 解析 、 接 
收 和 发 送 ， 主 机 Host) 是 控制 不 同 设 备 之 间 如 何 进行 数据 交换 ， 应 用 端 (Apps) 实现 具体 应 用 。 

(1) 控制 器 (Controller) 

Controller 实现 射频 相关 的 模拟 和 数字 部 分 , 完成 最 基本 的 数据 发 送 和 接收 ，Controller 对 外 接口 是 
天 线 ， 对 内 接口 是 主机 控制 器 接口 HCI (Host Controller Interface); 控制 器 包含 物理 层 PHY (Physical 
Layer)、 链 路 层 LL (Linker Layer)、 直 接 测试 模式 DTM (Direct Test Mode) 以 及 主机 控制 器 接口 HCI. 

м ”物理 层 PHY 

GFSK 信号 调制 ，2402 一 2480MHz，40 个 channel， 每 两 个 channel 间隔 2MHz (经 典 蓝牙 协议 是 
1MHz)， 数 据 传 输 速率 是 Mbps. 

M 直接 测试 模式 DTM 

为 射频 物理 层 测试 接口 ， 射 频数 据 分 析 之 用 。 

М жаи, 

基于 物理 层 PHY 之 上 ， 实 现 数据 通道 分 发 、 状 态 切 换 、 数 据 包 校 验 和 加 密 等 ， 链 路 层 LL 分 两 种 
通道 : 广播 通道 Advertising Channels) 和 数据 通道 (Data Channels); 广播 通道 有 3 个 ， 即 37ch 
(2402MHz), 38ch (2426MHz) 和 39ch (2480MHz)， 每 次 广播 都 会 往 这 3 个 通道 同时 发 送 〈 并 不 会 
在 这 3 个 通道 之 间 跳 频 )， 为 防止 某 个 通道 被 其 他 设备 阻塞 ， 以 至 于 设备 无 法 配对 或 广播 数据 ， 只 所 以 
XE 3 个 广播 通道 是 一 种 权衡 , 少 了 可 能 会 被 阻塞 , 多 了 会 加 大 功 耗 , 另外 3 个 广播 通道 刚好 避 开 了 WiFi 
的 Ich, 6ch 和 11ch， 所 以 在 BLE 广播 时 ， 不 至 于 被 WiFi 影响 〈 如 果 要 干扰 BLE 广播 数据 ， 一 个 最 
简单 的 办 法 就 是 , 同时 阻塞 3 个 广播 通道 ); 当 BLE 匹配 之 后 , 链 路 层 LL 由 广播 通道 切换 到 数据 通道 ， 
数据 通道 有 37 个 ， 数 据 传输 时 会 在 这 37 个 通道 间 切 换 ， 切 换 规则 在 设备 间 匹 配 时 约定 。 

(2) 主机 (Host) /控制 器 (Controller) 接口 HCI 

HCI 作为 一 种 接口 ， 存 在 于 主机 和 控制 器 中 ， 控 制 器 通过 HCI 发 送 数 据 和 事件 给 主机 ， 主 机 通过 
HCI 发 送 命令 和 数据 给 控制 器 。HCI 逻辑 上 定义 一 系列 的 命令 、 事 件 ， 物理 上 有 UART、SDIO 和 USB, 
实际 可 能 包含 里 面 的 任意 一 种 或 几 种 。 


422 ” 低 功 耗 蓝牙 分 类 


BLE 通常 应 用 在 传感器 和 智能 手机 或 者 平板 的 通信 中 。 到 目前 为 止 ， 只 有 很 少 的 智能 机 和 平板 支 
持 BLE， 如 iPhone 4S 以 后 的 苹果 手机 、Motorola Razr 和 the new iPad 及 其 以 后 的 iPad. AFHL Z 
渐 支 持 BLE， 安 卓 的 BLE 标准 在 2013 年 7 月 24 日 刚 发 布 。 智 能 机 和 平板 会 带 双 模 蓝牙 的 基带 和 协议 
栈 ， 协 议 栈 中 包括 GATT 及 以 下 的 所 有 部 分 ， 但 是 没有 GATT 之 上 的 具体 协议 。 所 以 ， 这 些 具 体 的 协 
议 需 要 在 应 用 程序 中 实现 ， 实 现时 需要 基于 各 个 GATT API 集 。 这 样 有 利于 在 智能 机 端 简单 地 实现 具 
体 协 议 ， 也 可 以 在 智能 机 端 简单 地 开发 出 一 套 基于 GATT 的 私有 协议 。 

在 现实 应 用 中 ， 低 功 耗 蓝牙 分 为 单 模 (Bluetooth Smart) 和 双 模 (Bluetooth Smart Ready) 两 种 设 


9) 
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备 。BLE 和 蓝牙 BR/EDR 有 所 区 分 ， 这 样 可 以 让 我 们 用 3 种 方式 将 蓝牙 技术 集成 到 具体 设备 中 。 因 为 
不 再 是 所 有 现 有 的 蓝牙 设备 可 以 和 另 一 个 蓝牙 设备 进行 互联 ， 所 以 准确 描述 产品 中 蓝牙 的 版 本 是 非常 
重要 的 。 下 面 将 详细 讲解 单 模 蓝 牙 和 双 模 蓝牙 的 基本 知识 。 
(1) 单 模 蓝牙 
单 模 蓝牙 设备 被 称 为 Bluetooth Smart 设备 ， 并 且 有 专用 的 Logo, ng 4-1 所 示 。 
在 现实 应 用 中 ， 手 表 、 运 动 传感器 等 小 型 设备 通常 是 基于 低 功 耗 单 模 蓝 牙 的 。 为 了 实现 极 低 的 功 
耗 效果 ， 在 硬件 和 软件 上 都 进行 了 优化 ， 这 样 的 设备 只 能 支持 BLE。 单 模 蓝 牙 芯片 往往 是 一 个 带 有 单 
模 蓝 牙 协 议 栈 的 产品 ， 这 个 协议 栈 通常 是 芯片 商 免费 提供 的 。 
(2) 双 模 蓝牙 
双 模 蓝牙 设备 被 称 为 Bluetooth Smart Ready 设备 ， 并 且 有 专用 的 Logo, WE 4-2 所 示 。 


© Bluetooth’ C Bluetooth’ 


SMART READY 
4-1 Bluetooth Smart 设备 4-2 Bluetooth Smart Ready 设备 


双 模 设备 支持 蓝牙 BR/EDR ЯП BLE. £EXUS ЖР, BR/EDR 和 BLE 技术 使 用 同一 个 射频 前 端 和 
天 线 。 典 型 的 双 模 设备 有 智能 手机 、 平 板 电脑 、PC 和 Gateway。 这 些 设 备 可 以 接收 到 通过 BLE 或 者 蓝 
F BR/EDR 设备 发 送 过 来 的 数据 ， 这 些 设备 往往 都 有 足够 的 供电 能 力 。 双 模 设备 和 BLE 设备 通信 的 功 
耗 低 于 双 模 设备 和 蓝牙 BR/EDR 设备 通信 的 功 耗 。 在 使 用 双 模 解决 方案 时 ， 需 要 用 一 个 外 部 处 理 器 才 
可 以 实现 蓝牙 协议 栈 。 


4.2.3” 低 功 耗 蓝牙 的 集成 方式 


尽管 有 单 模 和 双 模 方案 的 区 别 ， 但 是 在 设备 中 集成 蓝牙 技术 的 方式 有 多 种 ， 其 中 最 为 常用 的 方式 
有 模块 和 芯片 。 
(1) 模块 
在 现实 应 用 中 ， 最 简单 和 快速 的 方式 是 使 用 一 个 嵌入 式 模块 。 此 类 模块 包含 了 天 线 、 嵌 入 了 协议 
栈 并 提供 多 种 不 同 的 接口 : UART、USB、SPI 和 PC， 可 以 通过 这 些 接口 和 处 理 器 连接 。 模 块 会 提供 
一 种 简单 的 接口 来 控制 蓝牙 的 功能 。 很 多 的 模块 公司 都 会 提供 带 CE. FCC 和 IC 认证 的 产品 。 这 样 的 
模块 可 以 只 是 蓝牙 BR/EDR 的 、 双 模式 的 或 者 单 模式 的 。 
如 果 是 蓝牙 BRVEDR 和 双 模 的 方案 ， 还 可 以 采用 HCI 模块 。HCI 模块 不 带 蓝 牙 协议 栈 ， 其 他 的 和 
上 述 的 模块 是 一 样 的 。 所 以 ， 这 样 的 模块 会 更 便宜 。HCI 模块 只 是 提供 了 硬件 接口 ， 在 这 样 的 方案 中 ， 
蓝牙 协议 栈 需要 第 三 方 提供 。 这 样 的 第 三 方 协议 栈 要 求 能 在 主 设备 的 处 理 器 中 运行 ， 如 斯 图 曼 提供 的 
BlueCode+SR。 使 用 HCI 模块 需要 将 软件 移植 到 最 终 的 硬件 中 。 
从 理论 上 讲 ， 提 供 单 模 的 HCI 模块 也 是 可 以 的 。 然 而 ， 所 有 的 芯片 公司 都 已 经 将 GATT 集成 到 他 
们 的 芯片 中 ， 所 以 市 面 上 不 会 有 НСІ 单 模 模块 出 现 。 
(2) 芯片 
通过 芯片 来 集成 BLE 是 从 物料 角度 最 低 成 本 的 方式 ， 但 是 ， 这 需要 很 多 的 前 期 工作 和 花费 大 量 的 
时 间 。 虽 然 在 软件 上 只 需要 将 协议 栈 移 植 到 目标 平台 即 可 , 但 硬件 方面 则 需要 对 RF 的 layout 和 天 线 的 
设计 非常 有 经 验 。 这 些 公司 提供 的 BLE 芯片 有 Broadcom, CSR, EM Microelectronic, Nordic 和 TI. 
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424 低 功 耗 蓝牙 的 特点 


在 实际 应 用 过 程 中 ，BLE 的 低 功 耗 并 不 是 通过 优化 空中 的 无 线 射频 传输 实现 的 ， 而 是 通过 改变 协 
议 的 设计 来 实现 的 。 为 了 实现 极 低 的 功 耗 效果 ， 通 常 BLE 协议 设计 为 : 在 不 必要 射频 的 时 候 ， 彻 底 将 
空中 射频 关 断 。 

与 传统 蓝牙 BR/EDR 相 比 ，BLE 通过 如 下 3 大 特性 实现 低 功 耗 效果 。 

加 ”缩短 无 线 开启 时 间 。 

м ”快速 建立 连接 。 

回 降低 收发 峰值 功 耗 〈 有 具体 由 芯片 决定 )。 

缩短 无 线 开启 时 间 的 第 一 个 技巧 是 只 用 3 个 “广告 ”信道 ， 第 二 个 技巧 是 通过 优化 协议 栈 来 降低 
工作 周期 。 一 个 在 广告 的 设备 可 以 自动 和 一 个 在 搜索 的 设备 快速 建立 连接 ， 所 以 可 以 在 3 毫秒 内 完成 

在 现实 应 用 中 ， 低 功 耗 设 计 可 能 会 带 来 一 些 牺牲 ， 例 如 音频 数据 无 法 通过 BLE 来 进行 传输 。 尽 管 
如 此 , BLE 仍然 是 一 种 非常 出 色 的 技术 , 依然 会 支持 跳 频 (37 个 数据 信道 ), 并 且 采 用 了 一 种 改进 的 GFSK 
调制 方法 来 提高 链 路 的 稳定 性 。BLE et e 因为 在 芯片 级 提供 了 128bit AES 加 密 。 

单 模 设备 可 以 作为 Master 或 者 Slave， 但 是 不 能 同时 充当 两 种 角色 。 这 意味 着 BLE 只 能 建立 简单 
的 星 状 拓扑 , 不 能 实现 散射 网 。 在 BLE 2120 定义 了 低 功 耗 蓝牙 的 最 高 数据 率 为 305Kbps， 
但 这 只 是 理论 数据 。 在 实际 应 用 中 ， 数 据 的 吞吐 量 取决 于 上 层 协 议 栈 。 而 UART 的 速度 、 处 理 器 的 能 
力 和 主 设备 都 会 影响 数据 吞吐 能 力 

高 的 数据 吞吐 能 力 的 BLE 只 有 通过 私有 方案 或 者 基于 ATT notification 才能 实现 。 事 实 上 ， 如 果 是 
高 数据 率 或 高 数据 量 的 应 用 ， 蓝 牙 BR/EDR 通常 显得 更 加 省 电 。 


4.2.5 BLE 和 传统 蓝牙 BR/EDR 技术 的 对 比 


BLE 和 传统 蓝牙 BR/EDR 技术 的 对 比如 表 4-1 所 示 。 
表 4-1 BLE 和 传统 蓝牙 BR/EDR 技术 的 对 比 


Bluetooth BR/EDR 


2400—2483.5MHz 
- 801A. 


4~40mA 

OdBm (Class 1) / -6dBm (Class 2) 
Z-70dBm 

100ms 


Bluetooth Low Energ 
2400—2483.5MHz 


Frequency 
Deep Sleep 
Idle 

Peak Current 
Range 

Min. Output Power 
Max. Output Power 
Receiver Sensitivi 


+10dBm 
2-70dBm 


Encryption 


Connection Time 
Frequency Hopping 
Advertising Channel 
Data Channel 
Voice Capable 
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43 ”蓝牙 4.0 BLE 基础 


区 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \ 蓝 牙 4.0 BLE 基础 .avi 

蓝牙 4.0 也 被 称 为 Bluetooth Smart, 而 BLE 是 Bluetooth Low Energy 的 缩写 , 属于 蓝牙 低 功 耗 协议 ， 
Android 4.3 以 上 版 本 及 苹果 手机 等 都 支持 蓝牙 4.0 BLE, 主要 面向 传感器 应 用 市 场 提供 短 时间 小 数据 传 
输 ， 例 如 健康 领域 的 手机 监测 血压 、 体 育 领域 的 手机 计 步 器 等 。 本 节 将 详细 讲解 蓝牙 4.0 BLE 的 基础 
知识 。 


43.1 低 功 耗 是 最 大 特点 


蓝牙 4.0 是 2012 年 最 新 蓝牙 版 本 , 是 3.0 的 升级 版 本 ; 较 3.0 版 本 更 省 电 、 成 本 低 、3 毫秒 低 延 迟 、 
超 长 有 效 连接 距离 、AES-128 加 密 等 ， 通 常 被 用 在 蓝牙 耳机 、 蓝 牙 音 箱 等 设备 上 。 

蓝牙 4.0 最 重要 的 特性 是 省 电 , 极 低 的 运行 和 待机 功 耗 可 以 使 一 粒 纽扣 电池 连续 工作 数 年 之 久 。 此 
外 ， 低 成 本 和 跨 厂 商 互 操作 性 ，3 毫秒 低 延 迟 、AES-128 加 密 等 诸多 特色 ， 可 以 用 于 计 步 器 、 心 律 监视 
器 、 智 能 仪表 、 传 感 器 物 联网 等 众多 领域 ， 大 大 扩展 了 蓝牙 技术 的 应 用 范围 。 

蓝牙 4.0 已 经 走向 了 商用 , 在 最 新 款 的 Xperia Z. Galaxy S3. Galaxy S4、Note2、Note3 、SurfaceRT、 
iPhone 5S, iPhone 5. iPhone 4S、 魅 族 МХЗ. Moto Droid Razr. HTC One X、 小 米 手机 2. The New iPad, 
iPad 4, MacBook Air, Macbook Pro, 以 及 台 商 ACER AS3951 系列 /Getway NV57 系列 、 ASUS UX21/31 
ZÆ NOTE 系列 上 都 已 应 用 了 蓝牙 4.0 技术 。 很 多 品牌 已 推出 蓝牙 4.0 版 本 周边 设备 ， 同 时 支持 蓝牙 
4.0 HI NFC 的 WOOWIHERO jabra MOTION 和 WOOWI 泡 我 等 ,支持 蓝牙 4.0 的 音箱 有 Big jambox、 
Braven 等 产品 。 

蓝牙 技术 联盟 (Bluetooth SIG) 2010 年 7 月 7 日 宣布 ,正式 采纳 蓝牙 4.0 核心 规范 (Bluetooth Core 
Specification Version 4.0)， 并 启动 对 应 的 认证 计划 。 会 员 厂 商 可 以 提交 其 产品 进行 测试 ， 通 过 后 将 获得 
蓝牙 4.0 标准 认证 。 该 技术 拥有 极 低 的 运行 和 待机 功 耗 ， 使 用 一 粒 纽扣 电池 甚至 可 连续 工作 数 年 之 久 。 

蓝牙 4.0 BLE 的 主要 特性 如 下 : 
超 低 的 峰值 、 平 均 和 待机 模式 功 耗 。 
使 用 标准 纽扣 电池 可 运行 一 年 乃至 数 年 。 
低 成 本 。 
不 同 厂商 设备 交互 性 。 
无 线 覆 盖 范围 增强 。 
完全 向 下 兼容 。 
低 延 迟 CAPT-X). 


43.2 ”推动 了 可 穿戴 设备 的 兴 


到 目前 为 止 ， 当 大 家 谈 到 可 穿戴 设备 时 都 要 提 到 一 个 参数 : 支持 蓝牙 还 是 用 无 线 网 络 与 智能 手机 
相连 。 这 是 衡量 可 穿戴 设备 是 否 能 与 智能 手机 上 的 软件 顺利 “对 话 ” 的 主要 依据 。 其 实在 过 去 的 一 段 


@ 


m= m m= m m m= 


时 间 内 ， 大 家 已 经 习惯 了 “Bluetooth X.0 版 ”的 说 法 , 其实 从 Bluetooth 4.0 开始 , 这 项 技术 被 Bluetooth 
SIG (Special Interest Group， 负 责 推 动 蓝牙 技术 标准 的 开发 和 将 其 授权 给 制造 商 的 非 营利 组 织 ) 改名 为 
Bluetooth Smart 或 Bluetooth Smart Ready. Bluetooth SIG 首席 营销 官 Suke Jawanda 对 PingWest iji: “Ж 
Ж Bluetooth SIG 也 将 继续 淡化 X.0 的 概念 ,将 更 加 强调 Bluetooth Smart， 原 因 是 X.0 是 说 给 极 客 听 的 ， 
而 Bluetooth SIG 希望 普通 消费 者 也 能 听 懂 。” 

可 穿戴 设备 与 智能 手机 之 间 的 数据 传输 方式 对 蓝牙 技术 的 要 求 也 与 以 往 不 同 。Suke Jawanda 用 自 
己 手腕 上 的 Fitbit Flex 举例 ,“ 过 去 当 我 们 谈 到 蓝牙 技术 和 数据 传输 , 主要 考虑 的 是 类 似 Spotify 这 种 在 
一 个 较 长 的 时 间 段 里 输送 数据 的 需求 ， 现 在 像 Fitbit Flex 是 先 收集 数据 ， 再 断 续 地 在 某 些 “时 刻 ' 里 将 
数据 传送 到 用 户 的 手机 上 , 两 种 数据 传输 方式 不 同 。 Bluetooth Smart 的 低 耗 能 技术 就 可 以 满足 这 一 需求 。” 

Suke Jawanda 向 PingWest 解释 说 :“ 现 在 不 少 设备 制造 商都 在 强调 自己 支持 蓝牙 低 耗 能 技术 

(Bluetooth Low Energy)， 其 实 它 只 是 Bluetooth Smart 其 中 的 一 个 功能 。 支 持 Bluetooth Smart 的 设备 

都 支持 蓝牙 低 耗 能 技术 ”。 

虽然 特意 强调 低 耗 能 技术 是 给 消费 者 造成 一 种 “省 电 省 流量 ”的 印象 ， 但 是 换个 角度 来 看 ， 每 个 
产品 说 明 自 己 支持 Bluetooth Smart 的 背后 就 是 可 穿戴 设备 为 什么 在 此 时 流行 的 重要 原因 之 一 一 一 
Bluetooth Smart 对 操作 系统 和 硬件 设备 的 支持 情况 ， 决 定 了 可 穿戴 设备 能 否 以 较 低 的 成 本 与 软件 进行 
数据 传输 ， 接 下 来 才 是 解决 软件 获得 数据 之 后 怎么 处 理 的 问题 。 

根据 Suke Jawanda 的 介绍 ，Bluetooth Smart 对 可 穿戴 设备 的 支持 分 成 硬件 和 软件 。 以 Fitbit 为 例 ， 
ШЖ Fitbit 开发 一 款 新 的 产品 ， 支 持 Bluetooth Smart， 同 时 要 求 软件 ， 也 就 是 从 105 或 者 Android 一 一 
操作 系统 层面 要 支持 Bluetooth Smart, WRM iOS 5 (iPhone 4S. 以 及 以 上 版 本 的 手机 ) 开始 支持 
Bluetooth Smart， 而 Google 直到 Android 4.3 才 开 始 支持 。 

当然 Bluetooth Smart 并 不 是 唯一 推动 穿戴 设备 发 展 的 原因 ， 有 些 可 穿戴 设备 可 以 用 其 他 方式 传输 
数据 ， 例 如 无 线 网 络 ， 但 是 人 们 不 可 能 一 直 在 无 线 网 络 环境 下 生活 。 

那 除了 可 穿戴 设备 外 ,汽车 除了 用 蓝牙 接 打 电话 ， 还 能 做 些 什 么 ? Suke Jawanda 说 :“ 现 在 我 们 知 
道 汽车 能 做 到 的 是 通过 蓝牙 进行 语音 操作 、 接 打 电 话 ， 未 来 我 们 想象 的 是 用 蓝牙 技术 可 以 不 再 用 钥匙 ， 
你 的 手机 就 可 以 作为 车 钥匙 ， 另 一 个 是 利用 更 多 的 传感器 收集 数据 ， 让 车 与 车 之 间 “ 对 话 '， 例 如 你 的 
车 可 以 知道 前 后 3 辆 车 的 时 速 , 当 他 们 减速 时 你 的 车 能 提醒 你 前 方 的 车 在 减速 可 能 是 遇 到 什么 情况 等 。 
但 这 里 最 大 的 问题 是 汽车 行业 技术 滞后 ,例如 你 现在 看 到 的 一 个 汽车 领域 的 新 技术 ， 真正 应 用 到 生产 、 
被 推广 恐怕 是 2 一 3 年 后 的 事情 ， 而 且 人 买 一 辆 车 的 期 待 是 要 用 10—15 年 的 ， 也 就 是 你 买 了 一 辆 车 之 
后 10 年 内 可 能 都 体验 不 到 汽车 领域 的 新 技术 了 ， 这 个 问题 现在 还 没有 很 好 的 解决 方案 。”。 


注意 : 本 节 的 内 容 引 用 自 “ZOL 网 的 科技 频道 : http://news.zol.com.cn/article/179109.html”。 


44 蓝牙 规范 


GA 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \ 蓝 牙 规范 .avi 

蓝牙 规范 即 Bluetooth Profile, Bluetooth SIG 定义 了 许多 Profile. Profile 的 目的 是 要 确保 Bluetooth 
设备 间 的 互通 性 〈Interoperability)， 但 是 Bluetooth 产品 无 须 实 现 所 有 的 Bluetooth 规范 Profile。 本 节 将 
详细 讲解 蓝牙 规范 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


44. 


的 类 别 。 


的 分 类 。 
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物 联网 开发 从 入 门 到 实战 


Bluetooth 常用 规范 


在 Bluetooth 系统 中 ， 定 义 了 如 下 所 示 的 常用 规范 。 
(1) 蓝牙 立体 声音 讯 传输 协议 A2DP 
蓝牙 立体 声音 讯 传输 协议 (Advance Audio Distribution Profile)， 功 能 是 播放 立体 声 。 
(2) 基本 图 像 规范 
基本 图 像 规范 (Basic Imaging Profile) 的 功能 是 在 装置 之 间 传 送 图 像 ， 可 以 将 其 再 细 分 为 如 下 所 示 


«ненае 


Image Push 

Image Pull 

Advanced Image Printing 
Automatic Archive 
Remote Camera 

Remote Display 


(3) 基本 打印 规范 
基本 打印 规范 (Basic Printing Profile) 可 以 将 文件 、 电 子 邮件 传 至 打印 机 打印 ， 主 要 包含 如 下 所 示 


M 
M 


ЫЫ === 


ЫШ ===. 


无 线 电话 规范 (Cordless Telephony Profile): 设置 了 蓝牙 无 线 电话 之 间 沟 通 的 规范 。 

内 通信 规范 (Intercom Profile): 是 另类 的 TCS (Telephone Control protocol Specification) 基底 
规范 ， 两 个 Bluetooth 通信 设备 间 沟 通 的 规范 。 

拨号 网 络 规范 : Baseband, LMP, L2CAP, SDP, RFCOMM 协定 所 需要 的 传输 需求 。 

传真 规范 (Fax Profile): 能 传输 传真 的 资料 。 

人 机 界面 规范 (Human Interface Device Profile): 可 以 支援 鼠标 和 键盘 功能 。 

头 戴 式 通话 器 规范 (Headset Profile): 能 够 将 声音 传送 到 蓝牙 耳机 设备 。 

序列 埠 规 范 〈Serial Port Profile): 用 来 取代 有 线 的 RS-232Cable o 

SIM 卡 存 取 规范 (SIM Access Profile): 用 于 存 取 手 机 内 的 SIM Fo 

同步 规范 (Synchronization Profile): 建立 在 serial port profile. generic access profile 与 generic 
access profile 之 上 。 

档案 传输 规范 (File Transfer Profile): Bluetooth 可 以 利用 OBEX 通信 协定 来 传送 档案 。 

泛 用 存 取 规范 (Generic Access Profile): 用 来 建立 连 线 。 

泛 用 物件 交换 规范 (Generic Object Exchange Profile): 使 用 OBEX 进行 物件 交换 。 

物件 交换 规范 (Object Push Profile): Bluetooth 利用 OBEX 通信 协定 在 两 个 设备 间 交 换 资料 。 
个 人 局 域 网 路 规范 (Personal Area Networking Profile): 可 以 支持 蓝牙 网 络 第 三 层 协 定 。 
电话 秒 存 取 规 范 (Phone Book Access Profile): 可 以 在 装置 之 间 互 换 电 话 短 。 

影像 分 享 规范 (Video Distribution Profile): 可 以 使 用 H.263 编码 算法 来 分 享 影像 信息 。 


442 ”蓝牙 协议 体系 结构 


整个 蓝牙 协议 体系 结构 可 分 为 底层 硬件 模块 、 中 间 协 议 层 和 高 端 应 用 层 3 大 部 分 。 链 路 管理 层 
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(LMP), 2317/5 (BBP) 和 蓝牙 无 线 电信 道 构 成 蓝牙 的 底层 模块 。BBP 层 负责 跳 频 和 蓝牙 数据 及 信息 
帧 的 传输 。LMP 层 负责 连接 的 建立 和 拆除 以 及 链 路 的 安全 和 控制 ， 它 们 为 上 层 软件 模块 提供 了 不 同 的 
访问 入 口 ， 但 是 两 个 模块 接口 之 间 的 消息 和 数据 传递 必须 通过 蓝牙 主机 控制 器 接口 的 解释 才能 进行 。 
也 就 是 说 ， 中 间 协 议 层 包括 逻辑 链 路 控制 与 适 配 协议 (L2CAP)、 服 务 发 现 协 议 (SDP). BOA 
i (RFCOMM) 和 电话 控制 协议 规范 (TCS). L2CAP 完成 数据 拆 装 、 服 务 质量 控制 、 协 议 复 用 和 组 
提取 等 功能 ， 是 其 他 上 层 协 议 实现 的 基础 ， 因 此 也 是 蓝牙 协议 栈 的 核心 部 分 。SDP 为 上 层 应 用 程序 提 
供 一 种 机 制 来 发 现 网 络 中 可 用 的 服务 及 其 特性 。 在 蓝牙 协议 栈 的 最 上 部 是 高 端 应 用 层 ， 它 对 应 于 各 种 
应 用 模型 的 剖面 ， 是 剖面 的 一 部 分 ， 目 前 定义 了 13 种 剖面 。 

(1) 蓝牙 低层 模块 

蓝牙 的 低层 模块 是 蓝牙 技术 的 核心 ， 是 任何 蓝牙 设备 都 必须 包括 的 部 分 。 蓝 牙 工作 在 2.4GHz 的 
ISM 频段 。 采 用 了 蓝牙 结束 的 设备 能 够 提供 高 达 720kbit/s 的 数据 交换 速率 。 

蓝牙 支持 电路 交换 和 分 组 交换 两 种 技术 , 分 别 定义 了 两 种 链 路 类 型 , 即 面向 连接 的 同步 链 路 (SCO) 
和 面向 无 连接 的 异步 链 路 (ACL)。 为 了 在 很 低 的 功率 状态 下 也 能 使 蓝牙 设备 处 于 连接 状态 ， 蓝 牙 规定 
了 3 种 节能 状态 ， 即 停 等 (Park〉 状 态 、 保 持 Hold) 状态 和 呼吸 (Snif) 状态 。 这 几 种 工作 模式 按 
照 节能 效率 以 升序 排 依 次 是 Sniff Hist. Hold 模式 、Park 模式 。 

蓝牙 采用 3 种 纠 错 方案 ， 分 别 是 1/3 前 向 纠 错 CFEC), 2/3 前 向 纠 错 和 自动 重 发 (ARQ)。 前 向 纠 
错 的 目的 是 减少 重 发 的 可 能 性 ， 但 同时 也 增加 了 额外 开销 。 然 而 在 一 个 合理 的 无 错误 率 环境 中 ， 多 余 
的 投标 会 减少 输出 ， 故 分 组 定义 的 本 身 也 保持 灵活 的 方式 ， 因 此 ， 在 软件 中 可 定义 是 否 采 用 FEC。 一 
般 而 言 , 在 信道 的 噪声 干扰 比较 大 时 蓝牙 系统 会 使 用 前 向 纠 错 方案 , 以 保证 通信 质量 : 对 于 SCO 链 路 ， 
使 用 1/3 前 向 纠 错 ; 对 于 ACL 链 路 ， 使 用 2/3 前 向 纠 错 。 在 无 编号 的 自动 请 求 重 发 方案 中 ， 一 个 时 隙 
传送 的 数据 必须 在 下 一 个 时 隙 得 到 收 到 的 确认 。 只 有 数据 在 接收 端 通过 了 报头 错误 检测 和 循环 元 余 校 
J& (CRC) 后 认为 无 错时 ， 才 向 发 送 端 发 回 确认 消息 ， 否 则 返回 一 个 错误 消息 。 

蓝牙 系统 的 移动 性 和 开放 性 使 得 安全 问题 变 得 及 其 重要 。 虽 然 蓝牙 系统 所 采用 的 调频 技术 已 经 提 
供 了 一 定 的 安全 保障 ， 但 是 蓝牙 系统 仍然 需要 链 路 层 和 应 用 层 的 安全 管理 。 在 链 路 层 中 ， 蓝 牙 系 统 提 
供 了 认证 、 加 密 和 密 钥 管理 等 功能 。 每 个 用 户 都 有 一 个 个 人 标识 码 (PIN) , 它 会 被 译 成 128bit 的 链 路 
密 钥 (Link Key) 来 进行 单 双向 认证 。 一 旦 认证 完毕 ， 链 路 就 会 以 不 同 长 度 的 密码 CEncryphon Key) 
来 加 密 (此 密码 以 shit 为 单位 增 减 ， 最 大 的 长 度 为 128bit)， 链 路 层 安 全 机 制 提供 了 大 量 的 认证 方案 和 
一 个 灵活 的 加 密 方案 〈 即 允许 协商 密码 的 长 度 )。 当 来 自 不 同 国家 的 设备 互相 通信 时 ， 这 种 机 制 是 极其 
重要 的 ， 因 为 某 些 国家 会 指定 最 大 密码 长 度 。 蓝 牙 系 统 会 选取 微微 网 中 各 个 设备 的 最 小 的 最 大 允许 密 
码 长 度 。 例 如 ， 美 国 允许 128bit 的 密码 长 度 ， 而 西班牙 仅 允 许 48bit， 这 样 当 两 国 的 设备 互通 时 ， 将 选 
FE 48bit 来 加 密 。 蓝 牙 系 统 也 支持 高 层 协议 栈 的 不 同 应 用 体内 的 特殊 的 安全 机 制 。 例 如 两 台 计算 机 在 进 
行商 业 卡 信息 交流 时 ， 一 台 计 算 机 就 只 能 访问 另 一 台 计算 机 的 该 项 业务 ， 而 无 权 访问 其 他 业务 。 蓝 牙 
安全 机 制 依赖 PIN 在 设备 间 建 立信 任 关 系 ， 一 旦 这 种 关系 建立 起 来 了 ， 这 些 PIN 就 可 以 存储 在 设备 中 
以 便 将 来 更 快捷 地 连接 。 

(2) 软件 模块 

L2CAP 是 数据 链 路 层 的 一 部 分 ,位 于 基带 协议 之 上 。L2CAP 向 上 层 提供 面向 连接 的 和 无 连接 的 数 
据 服务 ， 它 的 功能 包括 协议 的 复 用 能 力 、 分 组 的 分 割 和 重新 组 装 (Segmentation And Reaassembly) 以 
及 提取 (Group Abstraction). L2CAP 允许 高 层 协议 和 应 用 发 送 和 接受 高 达 64KB 的 数据 分 组 。 

SDP 为 应 用 提供 了 一 个 发 现 可 用 协议 和 决定 这 些 可 用 协议 的 特性 的 方法 。 蓝 牙 环境 下 的 服务 发 现 
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与 传统 的 网 络 环境 下 的 服务 发 现 有 很 大 的 不 同 , 在 蓝牙 环境 下 , 移动 的 RF 环境 变化 很 大 ,因此 业务 的 
参数 也 是 不 断 变换 的 。SDP 将 强调 蓝牙 环境 的 独特 的 特性 。 蓝 牙 使 用 基于 客户 /服务 器 机 制定 义 了 根据 
蓝牙 服务 类 型 和 属性 发 现 服务 的 方法 ， 还 提供 了 服务 浏览 的 方法 。 

RFCOMM 是 射频 通信 协议 ， 它 可 以 仿真 串 行 电缆 接口 协议 ， 符 合 ETSI0710 串口 仿真 协议 。 通 过 
RFCOMM, 蓝牙 可 以 在 无 线 环 境 下 实现 对 高 层 协议 , 如 PPP. TCP/IP, WAP 等 的 支持 。 另 外 , КЕСОММ 
可 以 支持 AT 命令 集 ， 从 而 可 以 实现 移动 电话 机 和 传真 机 及 调制 解 调 器 之 间 的 无 线 连 接 。 
蓝牙 对 语音 的 支持 是 它 与 WLAN 相 区 别 的 一 个 重要 标志 。 蓝牙 电话 控制 规范 是 一 个 基于 ITU-T # 
iX Q.931 的 采用 面向 比特 的 协议 ， 它 定义 了 用 于 蓝牙 设备 间 建 立 语音 和 数据 呼叫 的 呼叫 控制 信 令 以 及 
用 于 处 理 蓝牙 TCS 设备 的 移动 性 管理 过 程 。 


443 IRIE (BLE) 蓝牙 协议 


BLE 不 再 支持 传统 蓝牙 BR/EDR 的 协议 ， 例 如 传统 蓝牙 中 的 SPP 协议 在 BLE 中 就 不 复 存 在 。 在 
BLE 应 用 中 ， 所 有 的 协议 或 者 服务 都 是 基于 GATT (Generic Attribute Profile) 的 。 尽 管 有 些 传统 蓝牙 
中 的 协议 ， 如 HID 被 移植 到 了 BLE 中 ， 但 是 在 BLE 的 应 用 中 必须 区 分 协议 和 服务 。 其 中 服务 描述 自 
身 有 什么 特点 和 形式 ， 并 且 描述 清楚 如 何 应 用 这 些 特点 以 及 需要 什么 安全 机 制 。 而 应 用 协议 定义 了 其 
使 用 的 服务 ， 说 明 是 传感器 端 还 是 接收 端 ， 定 义 GATT 的 角色 (Server/Client) 和 GAP 的 角色 

(Peripheral/Central ) 。 

和 蓝牙 BR/EDR 协议 相 比 ， 因 为 所 有 的 功能 都 是 集成 在 GATT 终端 ， 这 些 基 于 其 上 的 应 用 协议 只 

是 对 GATT 提供 的 功能 的 使 用 ， 所 以 基于 GATT 的 应 用 协议 非常 简单 。 


4... 基于 GATT 的 协议 /服务 


截止 到 2013 年 7 月 ， 现 有 的 基于 GATT 的 协议 /服务 如 表 4-2 所 示 。 
表 4-2 基于 GATT 的 协议 /服务 


GATT-Based Specifications (Qualifiable) Adopted Version 
ANP Alert Notification Profile 1.0 
ANS Alert Notification Service 1.0 
BAS Battery Service 1.0 
BLP Blood Pressure Profile 1.0 
BLS Blood Pressure Service 1.0 
CPP Cycling Power Profile 1.0 
CPS Cycling Power Service 1.0 
CSCP Cycling Speed and Cadence Profile 1.0 
CSCS Cycling Speed and Cadence Service 1.0 
CTS Current Time Service 1.0 
DIS Device Information Service 11 
ЕМР Find Me Profile 10 
GLP Glucose Profile 1.0 
HIDS HID Service 1.0 
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续 表 
GATT-Based Specifications (Qualifiable) Adopted Version 
HOGP HID over GATT Profile 1.0 
HTP Health Thermometer Profile 1.0 
HTS Health Thermometer Service 1.0 
HRP Heart Rate Profile 1.0 
HRS Heart Rate Service 1.0 
IAS Immediate Alert Service 1.0 
LLS Link Loss Service 1.0 
LNP Location and Navigation Profile 1.0 
LNS Location and Navigation Service 10 
NDCS Next DST Change Service 10 
PASP Phone Alert Status Profile 1.0 
PASS Phone Alert Status Service 1.0 
PXP Proximity Profile 10 
RSCP Running Speed and Cadence Profile 1.0 
RSCS Running Sj and Cadence Service 1.0 
RTUS Reference Time Update Service 10 
ScPP Scan Parameters Profile 1.0 
ScPS Scan Parameters Service 1.0 
TIP Time Profile 1.0 
TPS Tx Power Service 1.0 


4.4.5” 双 模 协 议 栈 和 单 模 协议 栈 


图 4-3 展示 了 斯 图 曼 双 模 协议 栈 BlueCode+SR 的 具体 架构 ,在 此 架构 图 中 包含 了 SPP、.HDP 和 GATT 


所 需要 的 所 有 部 分 。 
图 4-4 展示 了 单 模 协 议 栈 的 一 种 典型 协议 栈 设 计 。 
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аз 斯 图 曼 双 模 协议 栈 BlueCodetSR 的 具体 架构 


Application 
specific 


GATT Profiles 


GATT 


GAP АТТ 


(e)L2CAP 


нс! 


图 4-4 单 模 协议 栈 的 一 种 设计 


在 单 模 协议 栈 中 一 般 不 会 包含 具体 协议 ， 所 以 需要 在 具体 的 应 用 程序 中 实现 每 一 个 具体 应 用 对 应 
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的 协议 。 这 和 传统 蓝牙 有 非常 大 的 区 别 , 传统 蓝牙 会 在 协议 栈 中 实现 每 个 具体 应 用 相关 的 协议 , 如 SPP. 
НОР 等 。 和 双 模 协议 栈 相 比 ，BLE 无 须 一 个 主 处 理 器 来 实现 它 的 协议 栈 ， 所 以 极 低 功 耗 的 集成 成 为 可 
能 。 大 多 数 的 单 模 芯片 或 者 模块 都 是 自 带 协议 栈 的 。 

因为 BLE 单 模 产 品 (芯片 或 者 模块 ) 中 的 协议 栈 只 是 实现 了 GATT 层 ， 所 以 通常 需要 将 具体 应 用 
对 应 的 协议 集成 到 该 单 模 产品 中 。 甚 至 芯片 商都 开始 提供 带 有 具体 协议 和 Sample Code 的 SDK. 但 是 ， 
仍然 没有 真正 能 拿 到 手 的 解决 方案 。 


45 低 功 耗 蓝牙 协议 栈 详解 


ГЮ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 4 章 \ 低 功 耗 蓝牙 协议 栈 详解 .avi 

在 大 家 的 印象 中 ， 提 到 协议 栈 时 都 会 想到 开放 式 系统 互联 (OSD 协议 栈 ，OSI 协 议 栈 定义 了 厂商 
们 如 何 才能 生产 可 以 与 其 他 厂商 的 产品 一 起 工作 的 产品 。 协 议 栈 是 指 一 组 协议 的 集合 ， 例 如 把 大 象 装 
到 冰箱 里 需要 3 步 , 每 步 就 是 一 个 协议 , 3 步 组 成 一 个 协议 栈 。 本 节 将 详细 讲解 低 功 耗 蓝牙 协议 栈 的 基 
本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


4.5.1 ”什么 是 蓝牙 协议 栈 


蓝牙 协议 栈 就 是 SIG (Special Intersted Group) 定义 的 一 组 协议 的 规范 ， 目 标 是 允许 遵循 规范 的 蓝 
牙 应 用 能 够 进行 相互 间 操作 ， 图 4-5 展示 了 完整 蓝牙 协议 栈 和 部 分 Profile. 


уСага/уСа! WAE 
TCcs 二 进 制 
OBEX WAP 
AT 指令 
UDP | TCP/IP К SDP 
PPP 
І iH 音 
PECOMM uet 
L2CAP 
主 控制 器 接口 CHCI LMP 
基带 
蓝牙 无 线 电 信道 


图 4-5 完整 蓝牙 协议 栈 和 部 分 Profile 
在 蓝牙 系统 中 ，Profile 是 配置 文件 ， 其 定义 了 可 能 的 应 用 ， 蓝 牙 配置 文件 表达 了 一 般 行 为 ， 蓝 牙 
设备 可 以 通过 这 些 行为 与 其 他 设备 进行 通信 。 在 蓝牙 系统 中 定义 了 广泛 的 配置 文件 ， 描 述 了 许多 不 同 
类 型 的 使 用 案例 。 按 照 蓝 牙 规格 中 提供 的 指导 ， 开 发 商 可 以 创建 应 用 程序 以 与 其 他 符合 蓝牙 规格 的 设 
备 协同 工作 。 到 目前 为 止 , 在 蓝牙 系统 中 一 共有 20 多 个 Profile. 在 www.bluetooth.com 中 有 各 个 Profile 
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的 详细 说 明文 档 。 在 这 些 众多 的 协议 栈 中 ， 其 中 已 经 实现 了 的 协议 栈 如 下 。 


9 


ЕЕ 
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[ra] 


zi 


4.5.2 


Widcomm: 第 一 个 Windows 上 的 协议 栈 ， 由 Widcomm 公司 开发 ， 也 就 是 现在 的 Broadcom. 
Microsoft Windows Stack: Windows XP SP2 中 包括 了 这 个 内 建 的 协议 栈 ， 开 发 者 也 可 以 调 
其 API 开 发 第 三 方 软件 。 

Toshiba Stack: 这 也 是 基于 Windows 的 ,不 支持 第 三 方 开发 ,但 它 把 协议 栈 授权 给 一 些 laptop 
商 , 例如 Sony。 它 支持 的 Profile 有 SPP. DUN. FAX. LAP, OPP, FTP、HID、HCRP、 PAN, 
BIP、HSP、HFP、A2DP、AVRCP 和 GAVDP。 

BlueSoleil: 著名 的 ТУТ 公司 的 产品 ， 该 产品 可 以 用 于 桌面 和 嵌入 式 ， 也 支持 第 三 方 开发 ， 例 
11 DUN, FAX. НЕР. HSP, LAP, OBEX, OPP. PAN SPP. AV. BIP, FTP, GAP, HID, 
SDAP 和 SYNC. 

Blues: 是 Linux 官方 协议 栈 ， 该 协议 栈 的 上 层 用 Socket 封装 ， 便 于 开发 者 使 用 ， 通 过 DBUS 
与 其 他 应 用 程序 通信 。 

Affix: 是 NOKIA 公司 的 协议 栈 ， 在 Symbian 系统 上 运行 。 

BlueDragon: 是 东软 公司 产品 ， 在 2002 年 6 月 就 通过 了 蓝牙 的 认证 ， 支 持 的 Profile 有 SDP、 
Serial-DevB, AVCTP, AVRCP-Controller, AVRCP-Target, Headset-AG、Headset-HS、OPP-Client、 
OPP-Server. CT-GW. CT-Term, Intercom, FT-Server. FT-Client; САР. SDAP. Serial-DevA, 
АУРТР. GAVDP. A2DP-Source fll A2DP-Sink. 

BlueMagic: 这 是 美国 Open Interface 公司 for portable embedded device 的 协议 栈 ,iPhoneCapple)、 
nav-u (sony) 等 很 多 电子 产品 都 用 该 商业 的 协议 栈 , BlueMagic 3.0 是 第 一 个 通过 Bluetooth 9) 
议 栈 1.1 认证 的 协议 栈 。 

BCHS-Bluecore Host Software: 这 是 蓝牙 芯片 CSR 的 协议 栈 ， 同 时 也 提供 了 一 些 上 层 应 用 的 
Profile 的 库 ， 当 然 也 是 为 嵌入 式 产品 提供 的 服务 ， 支 持 的 Profile 有 A2DP、AVRCP、PBAP、 
ВІР. BPP. CTP. DUN, FAX, FM API, FTP GAP、GAVDP、GOEP、HCRP、Headset、HF1.5、 
НІ”. ICP, JSR82. LAP Message Access Profile, OPP, PAN. SAP, SDAP, SPP. SYNC 和 
SYNC ML. 

Windows CE: 微软 给 Windows CE 开发 的 协议 栈 ， 但 是 Windows CE 本 身 也 支持 其 他 的 协 
议 栈 。 

BlueLet: 是 IVT 公司 forembedded product 的 轻 量 级 协议 栈 。 


蓝牙 协议 体系 中 的 协议 


在 蓝牙 协议 体系 中 的 协议 中 ， 按 SIG 的 关注 程度 分 为 如 下 4 层 。 


M 


[sl 


核心 协议 : BaseBand. LMP, L2CAP fil SDP. 

电缆 替代 协议 : RFCOMM. 

电话 传送 控制 协议 : TCS-Binary 和 AT 命令 集 。 

选用 协议 : PPP. UDP/TCP/IP, OBEX, WAP. vCard. vCal, ЕМС 和 МАЕ. 


除 上 述 协议 层 外 ， 规 范 还 定义 了 主机 控制 器 接口 (HCI)， 它 为 基带 控制 器 、 连 接管 理 器 、 硬 件 状 
态 和 控制 寄存 器 提供 命令 接口 。 在 图 4-5 中 ，HCI 位 于 L2CAP 的 下 层 , fH HCI 也 可 位 于 L2CAP 上 层 。 
蓝牙 核心 协议 由 SIG 制定 的 蓝牙 专用 协议 组 成 ， 绝 大 部 分 蓝牙 设备 都 需要 核心 协议 (加 上 无 线 部 
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分 )， 而 其 他 协议 则 根据 应 用 的 需要 而 定 。 总 之 ， 电 缆 蔡 代 协 议 、 电 话 控制 协议 和 被 采用 的 协议 在 核心 
协议 基础 上 构成 了 面向 应 用 的 协议 。 

在 现实 应 用 中 ， 常 用 蓝牙 核心 协议 类 型 如 下 所 示 。 

(1) 基带 协议 

基带 和 链 路 控制 层 确保 微微 网 内 各 蓝牙 设备 单元 之 间 由 射频 构成 的 物理 连接 。 蓝 牙 的 射频 系统 是 
一 个 跳 频 系统 ， 其 任 一 分 组 在 指定 时 隙 、 指 定 频率 上 发 送 。 它 使 用 查询 和 分 页 进程 同步 不 同 设备 间 的 
发 送 频 率 和 时 钟 ， 为 基带 数据 分 组 提供 了 两 种 物理 连接 方式 ， 即 面向 连接 (SCO) 和 无 连接 (ACL), 
而 且 在 同一 射频 上 可 实现 多 路 数据 传送 。ACL 适用 于 数据 分 组 ，SCO 适用 于 话音 以 及 话音 与 数据 的 组 
合 ， 所 有 的 话音 和 数据 分 组 都 附 有 不 同 级 别 的 前 向 纠 错 (FEC) 或 循环 元 余 校 验 (CRC )， 而 且 可 进行 
加 密 。 此 外 ， 对 于 不 同 数据 类 型 (包括 连接 管理 信息 和 控制 信息 都 分 配 一 个 特殊 通道 。 

可 使 用 各 种 用 户 模式 在 蓝牙 设备 间 传 送 话 音 ， 面 向 连接 的 话音 分 组 只 需 经 过 基带 传输 ， 而 不 到 达 
L2CAP。 话 音 模 式 在 蓝牙 系统 内 相对 简单 ， 只 需 开通 话音 连接 即 可 传送 话音 。 

(2) 连接 管理 协议 (LMP) 

该 协议 负责 各 蓝牙 设备 间 连 接 的 建立 。 它 通过 连接 的 发 起 、 交 换 、 核 实 ， 进 行 身份 认证 和 加 密 ， 
通过 协商 确定 基带 数据 分 组 大 小 。 它 还 控制 无 线 设备 的 电源 模式 和 工作 周期 ， 以 及 微微 网 内 设备 单元 
的 连接 状态 。 

(з) 逻辑 链 路 控制 和 适 配 协 议 (L2CAP) 

该 协议 是 基带 的 上 层 协 议 ， 可 以 认为 它 与 LMP 并 行 工 作 ， 它 们 的 区 别 在 于 ， 当 业务 数据 不 经 过 
LMP 时 ，L2CAP 为 上 层 提供 服务 。L2CAP 向 上 层 提供 面向 连接 的 和 无 连接 的 数据 服务 ， 它 采用 了 多 
路 技术 、 分 割 和 重组 技术 、 群 提取 技术 。L2CAP 允许 高 层 协议 以 64K 字 节 长 度 收发 数据 分 组 。 虽 然 基 
带 协议 提供 了 SCO 和 ACL 两 种 连接 类 型 {Н L2CAP 只 支持 ACL。 

(4) 服务 发 现 协议 (SDP) 

发 现 服务 在 蓝牙 技术 框架 中 起 着 至 关 重 要 的 作用 ， 它 是 所 有 用 户 模式 的 基础 。 使 用 SDP 可 以 查询 
到 设备 信息 和 服务 类 型 ， 从 而 在 蓝牙 设备 间 建 立 相应 的 连接 。 

(5) 电缆 蔡 代 协议 (RFCOMM) 

RFCOMM 是 基于 ETSI-07.10 规范 的 串 行 线 仿真 协议 。 它 在 蓝牙 基带 协议 上 仿真 RS-232 控制 和 数 
据 信号 ， 为 使 用 串 行 线 传送 机 制 的 上 层 协议 (如 OBEX) 提供 服务 。 

(6) 电话 控制 协议 

М ”二 元 电话 控制 协议 (TCS-Binary 或 TCSBIN): 是 面向 比特 的 协议 ， 它 定义 了 蓝牙 设备 间 建 立 

语音 和 数据 呼叫 的 控制 信 令 ， 定 义 了 处 理 蓝 牙 TCS 设备 群 的 移动 管理 进程 。 基 于 ITU TQ.931 
建议 的 TCSBinary 被 指定 为 蓝牙 的 二 元 电话 控制 协议 规范 。 

AT 命令 集 电话 控制 协议 : SIG 定义 了 控制 多 用 户 模式 下 移动 电话 和 调制 解 调 器 的 AT 命令 集 ， 

该 AT 命令 集 基 于 ITU TV.250 协议 和 GSM07.07 指令 集 ， 它 还 可 以 用 于 传真 业务 。 

(7) 选用 协议 

点 对 点 协议 (PPP): 在 蓝牙 技术 中 ，PPP 位 于 RFCOMM 上 层 ， 完 成 点 对 点 的 连接 。 

TCP/UDP/P : 该 协议 是 由 互联 网 工程 任务 组 制定 ， 广 泛 应 用 于 互联 网 通信 的 协议 。 在 蓝牙 设 

备 中 ， 使 用 这 些 协议 是 为 了 与 互联 网 相连 接 的 设备 进行 通信 。 
对 象 交换 协议 (OBEX): IOBEX (简写 为 OBEX) 是 由 红外 数据 协会 DA) 制定 的 会 话 层 


(m, 


协议 ， 它 采用 简单 的 和 自发 的 方式 交换 目标 。OBEX 是 一 种 类 似 于 HTTP 的 协议 ， 它 假设 传 
输 层 是 可 靠 的 ， 采 用 客户 机 /服务 器 模式 ， 独 立 于 传输 机 制 和 传输 应 用 程序 接口 CAPD. 
例如 电子 名 片 交换 格式 〈vCard)、 电 子 日 历 及 日 程 交 换 格 式 〈vCal) 都 是 开放 性 规范 ， 它 们 都 没 
有 定义 传输 机 制 ， 而 只 是 定义 了 数据 传输 格式 。SIG 采用 vCard/vCal 规范 ， 是 为 了 进一步 促进 个 人 信 
息 交 换 。 
М 无线 应 用 协议 (WAP): 该 协议 是 由 无 线 应 用 协议 论坛 制定 的 ， 它 融合 了 各 种 广 域 无 线 网 络 技 
术 ， 其 目的 是 将 互联 网 内 容 和 电话 传送 的 业务 传送 到 数字 蜂窝 电话 和 其 他 无 线 终端 上 。 
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BLE 低 功 耗 蓝牙 协议 有 很 多 个 版 本 ， 不 同 的 厂商 提供 的 低 功 耗 蓝牙 协议 会 有 所 区 别 。 因 为 目前 市 
场 的 表现 情况 , 本 节 将 详细 讲解 使 用 最 为 频繁 的 TI (德州 仪器 ) 公司 BLE 低 功 耗 蓝 牙 协 议 的 基本 知识 。 
4.6.1 获取 蓝牙 协议 栈 

TI (德州 仪器 ) 公司 提供 了 多 个 版 本 的 BLE 低 功 耗 蓝牙 协议 栈 , 读者 可 以 登录 其 官方 网 站 来 下 载 ， 
如 图 4-6 所 示 。 
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RTD Temperature Transmitter 
Reference Design 


1 
+ Industry standard form factor, compatible with 2-, 3-, and 4-wire RTD probes. HY, 
* Maximum measured error: 0.11°C (-200°C to 200°C), 0.17°C (-200°C to 660°C) ine 
* EMC optimized (IEC61000-4-2, IEC61000-4-4: pre-compliance testing) 
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图 4-6 TI 公司 的 官方 站 点 


笔者 下 载 的 版 本 是 BLE-CC254x-1.3.exe， 双 击 此 文件 后 可 以 进行 安装 工作 ， 有 具体 安装 过 程 如 下 : 
C1) 进入 “解压 缩 ” 界 面 ， 单 击 Next 按钮 ， 如 图 4-7 所 示 。 

(2) 进入 同意 安装 协议 界面 ,选中 Iaccept the agreement 单 选 按钮 ， 单 击 Next 按钮 ， 如 图 4-8 所 示 。 
G) 进入 选择 安装 路 径 界 面 ， 通 过 Browse 按钮 选择 安装 路 径 ， 如 图 4-9 所 示 。 

(4) 进入 准备 安装 界面 ， 单 击 Install 按钮 开始 安装 ， 如 图 4-10 所 示 。 

(5) 进入 安装 进度 界面 ， 此 过 程 需要 耐心 等 待 ， 如 图 4-11 所 示 。 

(6) 进入 安装 完成 界面 ， 整 个 安装 过 程 结 束 ， 如 图 4-12 所 示 。 
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Welcome to the BLE-CC254x 
Setup Wizard 


This ий install BLE-CC254x version 1.3 оп your computer. 


Itis recommended that you dose all other applications before 
‘continuing, 


ick Next to continue, or Cancel to exit Setup. 
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4-7 “解压 缩 ”界面 


Select Destination Location 
"Where should BLE-CC254x be installed? 
| Sete wil instal BLE-CC254 nto the folowing folder, 


To continue, cick Next. If you would lke to select a different folder, dk Browse. 


uccisi A 


Atleast 82.0 MB of free disk space is required. 


_== | 


图 4-9 选择 安装 路 径 界 面 


Installing 
Please wait while Setup installs BLE-CC2S4x on your computer. 


C:\BLE-CC254x-1.3)EULA pdf 


h 
图 4-11 安装 进度 界面 
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Please read the folowing License Agreement. You must accent the terms of this 
agreement before contrung with the nstalaton. 


Texas Instruments Incorporated 
BLE Software License Agreement 


Important - Please read the following license agreement 
carefully. This is a legally binding agreement. After 
You read this license agreement, You will be asked 
whether You accept and agree to the terms of this 
license agreement. Do not click “I have read and >| 


© 1 accept the agreement 
r 


—“ | 
4-8 同意 安装 协议 界面 


Ready to Install 
‘Setup в now ready to begn instaling BLE-CC254x оп your computer. 


‘Click Install to continue with the installation, or dick Back f you want to review or 
change any settings. 


Destination locaton: 
СМЕ СС25%-13 


jf 
— ии om | 
图 4-10 准备 安装 界面 


Completing the BLE-CC254x 
Setup Wizard 


Setup has finished instaling BLE-CC254x on your computer. 
The application may be launched by selecting the installed 


ick Finish to exit Setup. 


View the Release Notes 


[umen] 
图 4-12 ”安装 完成 界面 


安装 完成 后 ， 需 要 使 用 IAR 集成 开发 环境 打开 工程 文件 。 例 如 TI 公司 在 Projects\ble\SimpleBLE 


Peripheral\ 目 录 下 提供 了 实例 工程 ， 通 过 使 用 IAR 工具 打开 .eww 文件 的 方式 可 以 浏览 整个 工程 。 
SER: 读者 可 以 自行 下 载 并 安装 IAR 集成 开发 环境 。 


m, 


4.6.2 


вав manage ОП 


BLE 蓝牙 协议 栈 结构 


注意 : 在 后 面 的 内 容 中 , 笔者 参考 了 TI 公司 的 官方 资料 (CC2540Bluetooth Low Energy Software Developer's 


Guide (Rev. B)》， 部 分 图 片 也 是 直接 引用 自 上 述 参考 文档 。 


BLE 蓝牙 协议 栈 分 为 两 个 部 分 ， 分 别 是 控制 器 和 主机 。 对 于 4.0 以 前 的 蓝牙 ， 这 两 部 分 是 分 开 的 。 
所 有 profile〈 剧 本 ， 用 来 定义 设备 或 组 件 的 角色 ) 和 应 用 都 建构 在 GAP 或 GATT ŻE. BLE 蓝牙 协议 
栈 的 结构 如 图 4-13 所 示 。 
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Р 4-13 BLE 蓝牙 协议 栈 的 结构 


在 BLE 蓝牙 协议 栈 的 结构 中 ， 从 上 到 下 的 具体 说 明 如 下 。 


A 


ARARA 


PHY J: 工作 车 间 , 1Mbps 自 适 应 跳 频 GFSK( 高 斯 频 移 键 控 ), 运行 在 免 许可 证 使 用 的 2.4GHz 
频段 中 。 

LL 层 : 为 RF 控制 器 ， 控 制 室 ， 控 制 设 备 处 于 准备 〈Standby)、 广 播 、 监 听 / 扫 描 《〈Scan)、 初 
始 化 、 连 接 这 5 种 状态 的 一 种 。5 种 状态 切换 描述 为 : 未 连接 时 ,设备 广播 信息 (向 周围 邻居 
讲 “ 我 来 了 ”)， 另 外 一 个 设备 一 直 监 听 或 按 需 扫描 ， 两 个 设备 连接 初始 化 ( 搬 几 把 椅子 到 院 
子 )， 设 备 连 接 上 了 〈 开 聊 )。 发 起 聊天 的 设备 为 主 设备 ， 接 收 聊天 的 设备 为 从 设备 ， 同 一 次 
聊天 只 能 有 一 个 意见 领袖 ， 即 主 设备 和 从 设备 不 能 切换 。 

HCI 层 : 为 接口 层 ， 通 信 部 ， 向 上 为 主机 提供 软件 应 用 程序 接口 “API)， 对 外 为 外 部 硬件 控 
制 接口 ， 可 以 通过 串口 、SPI、USB 来 实现 设备 控制 。 

L2CAP E: 物流 部 ， 负 责 行李 打包 和 拆 封 处 ， 提 供 数据 封装 服务 。 

SM 层 : 保卫 处 ， 提 供 配对 和 密 匙 分 发 ， 实 现 安全 连接 和 数据 交换 。 

AIT 层 : 库房 ， 负 责 数据 检索 。 

GATT 层 : 出 纳 /库房 前 台 ， 出 纳 负 责 处 理 向 上 与 应 用 打交道 ， 而 库房 前 台 负 责 向 下 把 检索 任 
务 子 进程 交 给 ATT 库房 去 做 ， 其 关键 工作 是 为 检索 工作 提供 合适 的 profile 结构 ， 而 profile 


由 检索 关键 词 (Characteristics) 组 成 。 


БЕ 


GAP Jz: 秘书 处 ， 对 上 级 提供 应 用 程序 接口 ， 对 下 级 管理 各 级 职能 部 门 ， 尤 其 是 指示 LL Jë 
控制 室 5 种 状态 切换 ， 指 导 保 卫 处 做 好 机 要 工作 。 

蓝牙 为 了 实现 同 多 个 设备 相连 或 实现 多 功能 的 目标 ， 也 实现 了 功能 扩充 ， 这 就 产生 了 调度 问题 。 
因为 ， 虽 然 软件 和 协议 栈 可 扩充 ， 但 终究 最 底层 的 执行 部 门 只 有 一 个 。 为 了 实现 多 事件 和 多 任务 切换 ， 
需要 把 事件 和 任务 对 应 的 应 用 ， 以 及 其 相关 的 提供 支撑 “办 公 室 ” 和 “工厂 ”的 对 象 打包 起 来 ， 并 起 
一 个 名 字 OSAL 操作 系统 抽象 层 ， 类 似 于 集团 公司 以 下 的 子 公司 。 

如 果实 现 软件 和 硬件 的 低 耦 合 ， 使 软件 不 经 改动 或 很 少 改动 即 可 应 用 在 另外 的 硬件 上 ， 这 样 就 方 
便 硬 件 改造 、 升 级 、 迁 移 后 软件 的 移植 。HAL 硬件 抽象 层 正 是 用 来 抽象 各 种 硬件 的 资源 ， 告 知 给 软件 。 
其 作用 类 似 于 嵌入 式 系统 设备 驱动 的 定义 硬件 资源 的 “.h” 头 文件 ， 其 角色 类 似 于 现代 工厂 的 设备 管 
理 部 。 


463 BLE 低 功 耗 蓝牙 系统 架构 


BLE 低 功 耗 蓝牙 系统 架构 如 图 4-14 所 示 。 

由 此 而 见 ,BLE 低 功 耗 蓝牙 软件 主要 由 两 部 分 
组 成 ， 分 别 是 OSAL 操作 系统 抽象 层 和 HAL fS 
件 抽 象 层 ， 多 个 Task 任务 和 事件 在 OSAL 管理 下 


Task 

-BLE Protocol Stack 
-Profiles 
-Application 
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工作 , 而 每 个 任务 和 事件 又 包括 3 个 部 分 , 分 别 是 OSAL 操 作 系统 抽象 导 
BLE 协议 栈 、profiles 和 应 用 程序 。 
(1) OSAL 操作 系统 抽象 层 | ucc LL NE | 
OSAL 作为 调度 核心 ， BLE 协议 栈 、profile 定 
义 和 所 有 的 应 用 都 围绕 它 来 实现 。 OSAL 不 是 传统 414 BLETCURSUERSURFIS 


大 家 使 用 的 操作 系统 , 而 是 一 个 允许 软件 建立 和 执 
行事 件 的 循环 。 软 件 功能 是 由 任务 事件 来 实现 的 ， 创 建 的 任务 事件 需要 完成 如 下 所 示 的 工作 。 
回 创建 task identifier 任务 ID. 
М ”编写 任务 初始 化 进程 ， 并 需要 添加 到 OSAL 初始 化 进程 中 ， 这 就 是 说 系统 启动 后 不 能 动态 添 
加 功能 。 
ED ”编写 任务 处 理 程序 。 
М ”提供 消息 服务 。 
BLE 协议 栈 的 各 层 都 是 以 OSAL 任务 方式 实现 ， 由 于 LL 控制 室 的 时 间 要 求 最 为 迫切 ， 所 以 其 任 
务 优先 级 最 高 。 为 了 实现 任务 管理 ，OSAL 通过 消息 处 理 、 存 储 管理 和 计时 器 定时 等 附加 服务 实现 。 
(2) 系统 启动 流程 
为 了 使 用 OSAL， 在 main 函数 的 最 后 要 启动 一 个 名 为 osal_start_system 的 进程 ， 该 进程 会 调用 由 
特定 应 用 决定 的 启动 函数 osalInitTasks 来 启动 系统 。osalInitTasks 逐个 调用 BLE 协议 栈 各 层 的 启动 进 
程 来 初始 化 协议 栈 。 随 后 设置 一 个 任务 的 Sbit 任务 ID (Task ID )， 跳 入 循环 等 待 执行 任务 ， 系 统 启动 
完成 。 
(3) 任务 事件 与 事件 处 理 
进程 优先 级 和 任务 ID 
> ”任务 优先 级 决定 于 任务 ID， 任务 ID 越 小 ， 优 先 级 越 高 。 
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> BLE 协议 栈 各 层 的 任务 优先 级 比 应 用 程序 的 高 。 
> ”初始 化 协议 栈 后 ， 越 早 调 入 的 任务 ,任务 ID 越 高 ， 优 先 级 越 低 ， 即 系统 倾向 于 处 理 新 到 
的 任务 。 

м ”事件 变量 和 旗 语 

每 个 事件 任务 由 对 应 的 16bit 事件 变量 来 标示 ， 事 件 状态 由 旗号 (Taskflag) 来 标示 。 如 果 事 件 处 
理 程 序 已 经 完成 ， 但 其 旗号 并 没有 移 除 ，OSAL 会 认为 事情 还 没有 完成 而 继续 在 该 程序 中 不 返回 。 例 
li, fÉ SimpleBLEPeripheral 实例 工程 中 ， 当 事件 START DEVICE EVT 发 生 ， 其 处 理 函 数 SimpleBLE 
Peripheral ProcessEvent 就 运行 ， 结 束 后 返回 16bit 事件 变量 ， 并 清除 旗 语 SBP START DEVICE EVT. 

事件 处 理 表 单 

每 当 OSAL 事件 检测 到 了 有 任务 事件 ， 其 相应 的 处 理 进 程 将 被 添加 到 由 处 理 进程 指针 构成 的 事件 
处 理 表单 中 ， 该 表单 名 为 taskArr (Taskarray)。taskArr 中 各 个 事件 进程 的 顺序 和 osalInitTasks 初始 化 函 
数 中 任务 ID 的 顺序 是 对 应 的 。 

М ”事件 调度 的 方法 

有 两 种 事件 调度 的 方法 ， 最 简单 的 方法 是 使 用 osal set event 函数 〈 函 数 原型 在 OSAL.h 文件 中 )， 
在 这 个 函数 中 ， 用 户 可 以 像 定义 函数 参数 一 样 设置 任务 ID 和 事件 旗 语 。 第 二 种 方法 是 使 用 osal start_ 
timerEx 函数 (函数 原型 在 OSAL_Timers.h 文件 中 )， 使 用 方法 同 osal_set_event 函数 ， 而 第 三 个 以 毫秒 
为 单位 的 参数 osal_start_timerEx 则 指示 该 事件 处 理 必 须要 在 这 个 限定 时 间 内 ， 通 过 定时 器 来 为 事件 处 
理 计时 。 

(4) 存储 管理 

存储 管理 类 似 于 Linux 嵌入 式 系统 内 存 分 配 C 函数 шеш alloc, OSAL 利用 osal mem alloc 提供 基 
本 的 存储 管理 , 但 osal mem alloc 只 有 一 个 用 于 定义 byte 数 的 参数 。 对 应 的 内 存 释放 函数 为 osal mem 
free。 

(5) 进程 间 通信 一 一 通过 消息 机 制 实现 

不 同 的 子 系统 通过 OSAL 的 消息 机 制 通信 。 消 息 即 为 数据 ， 数 据 种 类 和 长 度 都 不 限定 。 消 息 收发 
的 过 程 描 述 如 下 所 示 。 

在 接收 信息 时 调用 函数 osal msg allocate 创建 消息 占用 内 存 空间 (已 经 包含 了 osal mem alloc Á 
数 功 能 )， 需 要 为 该 函数 指定 空间 大 小 ， 该 函数 返回 内 存 空间 地 址 指针 ， 利 用 该 指针 就 可 以 把 所 需 数据 
复制 到 该 空间 。 

在 发 送 数据 时 调用 函数 osal_msg_send， 需 为 该 函数 指定 发 送 目标 任务 ，OSAL 通过 旗 语 SYS_ 
EVENT MSG 告知 目标 任务 ， 目 标 任 务 的 处 理 函数 调用 osal_msg_receive 来 接收 发 来 的 数据 。 建 议 每 
个 OSAL 任务 都 有 一 个 消息 处 理 函数 ， 每 当 任务 收 到 一 个 消息 后 ， 通 过 消息 的 种 类 来 确定 需要 本 任务 
做 相应 处 理 。 消 息 接收 并 处 理 完 成 ， 调 用 函数 osal msg deallocate 来 释放 内 存 (已 经 包含 了 osal mem_ 
free 函数 功能 )。 


4.6.4 ”硬件 抽象 层 HAL 和 BLE 低 功 耗 蓝 牙 协议 栈 


当 新 的 硬件 平台 做 好 后 ， 只 需 修 改 HAL， 而 不 需 修改 HAL 之 上 的 协议 栈 的 其 他 组 件 和 应 用 程序 。 
(1) BLE 库 文件 
TI 蓝牙 协议 栈 是 以 单独 一 个 库 文件 提供 的 ， 并 没有 提供 源 代 码 ， 因 此 不 做 深入 说 明 。 对 于 TI 的 
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BLE 实例 应 用 来 说 ， 这 个 单独 库 文件 完全 够 用 ， 因 为 已 经 列 出 了 所 有 的 库 文件 。 
(2) GAP 秘书 处 
角色 〈 即 服务 /功能 ) 
ETIKAF, GAP 运行 在 如 下 一 种 角色 中 。 
Broadcaster: 广播 员 一 一 我 在 ， 但 只 可 远 观 ， 不 可 连接 。 
Observer: 观察 员 一 一 看 看 谁 在 ， 但 我 只 远 观 ， 不 连接 。 
Peripheral: 9h (MHL) 一 一 我 在 ， 谁 要 我 就 跟 谁 走 ， 协 议 栈 单 层 连接 。 
Central: 核心 (主机 ) 一 一 看 看 谁 在 ， 并 且 愿 意 跟 我 走 我 就 带 她 /他 走 ， 协 议 栈 单 层 或 多 层 连 
接 ， 目 前 最 多 支持 3 个 同时 连接 。 
虽然 指标 显示 BLE 可 以 同时 扮演 多 个 角色 ， 但 是 在 TI 提供 的 BLE 实例 应 用 中 默认 只 支持 外 设 角 
色 。 每 一 种 角色 都 由 一 个 剧本 来 定义 。 
连接 
在 主 从 机 连接 过 程 中 ， 一 个 典型 的 低 功 耗 蓝 牙 系统 同时 包含 外 设 和 核心 (主机 )， 两 者 的 连接 过 程 
是 : 外 设 角色 向 外 发 送 自 己 的 信息 (设备 地 址 、 名 字 等 )， 主 机 收 到 外 设 广播 信息 后 ， 发 送 扫描 请 求 给 
外 设 ， 外 设 响 应 主机 的 请 求 ， 连 接 建立 完成 。 
连接 参数 主要 有 通信 间隙、 外 设 镭 视 、 最 大 耐心 等 待 时 间 等 ， 具 体 说 明 如 下 。 
通信 间隙: 蓝牙 通信 是 间断 的 、 跳 频 的 ， 每 次 连接 都 可 能 选择 不 同 的 子 频带 。 跳 频 的 好 处 是 
避免 频道 拥塞 ， 间 断 连接 的 好 处 是 节省 功 耗 ， 通 信和 间隙 就 是 指 两 次 连接 之 间 的 时 间 间 隔 。 这 
个 间隔 以 1.25ms 为 基本 单位 ， 最 小 6 单位 ， 最 大 3200 单位 ， 间 隙 越 小 通信 越 及 时 ， 间 隙 越 
大 功 耗 越 低 。 
М ”外 设 鄙视 ， 外 设 与 主机 建立 连接 以 后 ， 主 机 总 会 定期 发 送 问 候 信息 到 外 设 ， 外 设 不 接收 ， 这 
些 主机 发 送 的 信息 就 浮云 般 飘 过 。 可 以 忽略 的 连接 事件 个 数 从 0 一 499 个 ， 最 多 不 超过 32 秒 。 
有 效 连 接 间隙 = 连接 间隙 x (1+ 外 设 鄙视 )。 
М ”最 大 耐心 等 待 时 间 : 指 的 是 为 了 创建 一 个 连接 ， 主 机 人 允许 的 最 大 等 候 时 间 ， 在 这 个 时 间 内 ， 
不 停 地 尝试 连接 。 范 围 是 10 一 3200 个 通信 间隙 基本 单位 (1.25ms)。 
以 上 3 个 参数 大 小 设置 优 劣 是 显而易见 的 ， 连 接 参数 的 设置 请 阅读 本 小 节 后 面 的 内 容 。 
假如 主机 采用 从 机 并 不 舒坦 的 参数 来 请 求 连接 ， 有 如 主 从 机 已 经 连接 了 ， 但 从 机 有 想法 了 ， 要 改 
参数 条 约 。 通 过 “连接 参数 更 新 请 求 (Connection Parameter Update Request)” 来 解决 问题 , ^5 Н L2CAP 
“收发 室 物流 处 ”处 理 。 
在 实现 加 密 处 理 时 可 以 利用 配对 实现 ， 利 用 密 匙 来 加 密 授 权 连 接 。 典 型 的 过 程 是 : 外 设 向 主机 请 
求 口令 一 个 〈passkey) 以 便 进 行 配对 ， 待 主机 发 送 了 正确 的 口令 之 后 ， 连 接 通 信 通 过 主 从 机 互 换 密码 
来 校 验 。 由 于 蓝牙 通信 是 间断 通信 ， 如 果 一 个 应 用 需要 经 常 通信 ， 而 每 次 通信 都 要 重新 申请 连接 ， 那 
将 是 劳 神 费 力 的 ,为 此 GAP 安全 卫士 SM 提供 了 一 种 长 期 签证 (Long-termset of Keys), 叫做 绑 定 (Bonding)， 
这 样 每 次 建立 连接 通关 流程 就 简便 并 快捷 。 
(3) 出 纳 GATT 
GATT 负责 两 个 设备 间 通 信 的 数据 交互 。 共 有 两 种 角色 : 出 纳 员 (GATTClient ) 和 银行 
(САТТЅегуег), 银行 提供 资金 ， 出 纳 从 银行 存 取款 。 银 行 可 以 同时 面 对 多 个 出 纳 员 。 这 两 种 角色 和 主 
从 机 等 角色 是 无 关 的 。 
GATT 把 工作 拆 分 成 几 部 分 来 实现 : 读 关键 词 和 描述 符 ， 用 来 去 库房 查找 提取 数据 ， 并 写 / 读 关键 


(oe, 
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词 和 描述 符 。 

GATT #17 (САТТЅегуег) 的 业务 部 门 САРІ) 主要 提供 两 个 主要 的 功能 : 一 是 服务 功能 ， 注 册 或 
销毁 服务 ， 并 作为 回调 函数 ， 二 是 管理 功能 ， 添 加 或 删除 GATT 银行 业务 。 

一 个 角色 定义 的 剧本 可 以 同时 定义 多 个 角色 ， 每 个 角色 的 服务 、 关 键 词 、 关 键 值 和 描述 符 都 以 句 
N CAttributes) 形式 保存 在 角色 提供 的 服务 上 。 所 有 的 服务 都 是 一 个 gattAttribute t 类 型 的 array, TEX 
件 gatt.h. 中 定义 。 

(4) 调用 GAP 和 GATT 的 一 般 过 程 


= 8 === = 


GAP fll GATT 的 一 般 过 程 如 下 : 

API 调用 。 

协议 栈 响 应 并 返回 。 

协议 栈 发 送 一 个 OSAL 消息 〈 数 据 ) 去 调用 相应 任务 事件 。 
调用 任务 去 接收 和 处 理 消 息 。 

消息 清除 。 


以 设备 初始 化 为 GAP 外 设 角色 来 举例 说 明 ， 外 设 角色 由 其 剧本 来 决定 ， 实 例 程序 在 文件 
peripheral.c 内 。 


调用 API 函数 GAP_DeviceInit。 

GAP 检查 后 开始 初始 化 ， 返 回 值 为 SUCCESS (0x00)， 并 通知 BLE 工作 。 

BLE 协议 栈 发 送 OSAL 消息 给 外 设 角色 剧本 (Peripheral Roleprofile), 消息 内 容 包 括 要 干什么 
(Eventvalue) GAP_MSG EVENT 和 指标 是 什么 〈Opcodevalue， 参 数 )。 

角色 剧本 的 服务 任务 就 收 到 了 事件 请 求 SYS_ EVENT_MSG， 表 示 有 消息 来 了 。 

角色 剧本 接收 消息 ， 并 拆 看 到 底 是 什么 事 ， 接 着 把 消息 数据 转换 (Cast) 成 具体 要 干 的 事情 ， 

并 完成 相应 的 工作 (这 里 为 gapDeviceInitDoneEvent t)。 

角色 剧本 清除 消息 并 返回 。 例 如 GATT 客户 端 设备 想 从 GATT 服务 器 端 读 取 数 据 ， 即 GATT 

出 纳 想 从 GATT 银行 那 边 取 钱 。 

应 用 程序 调用 GATT 子 进程 API 函数 GATT_ReadCharValue, 传递 的 参数 为 连接 句柄 、 关 键 词 

句柄 和 自身 任务 的 ID. 

GATT 答应 了 这 个 请 求 ， 返 回 值 为 SUCCESS (0x00)， 向 下 告知 BLE 有 活 干 了 。 

BLE 协议 栈 在 下 次 建立 蓝牙 连接 时 ， 发 送 取 钱 的 指令 给 银行 ， 当 银行 通知 ， 我 们 正好 有 柜员 

空闲， 于 是 把 钱 取 出 来 交 给 BLE. 

BLE 接着 就 把 取 到 的 钱包 成 消息 (OSAL message)， 通 过 出 纳 GATT 返回 给 应 用 程序 。 消 息 
内 包含 GATT MSG EVENT 和 修改 了 的 АТТ READ RSP. 

应 用 程序 接收 到 从 OSAL 来 的 SYS_ EVENT_MSG 事件 ， 表 示 钱 可 能 到 了 。 

应 用 程序 接收 消息 ， 拆 包 检 查 ， 并 拿 走 需要 的 钱 。 

最 后 应 用 程序 把 包装 袋 销毁 。 


(5) GAP 角色 剧本 
在 TI 的 BLE 实例 应 用 中 提供 了 3 种 GAP 角色 剧本 , 分 别 是 保卫 处 角色 和 几 种 GATT 出 纳 / 库 管 示 
例 程序 服务 角色 。 


M 


GAP 外 设 剧本 


其 АРІ 函数 在 peripheralh 中 定义 ， 包 括 如 下 所 示 的 信息 。 


i) 
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GAPROLE ADVERT ENABLED: 广播 使 能 。 
GAPROLE ADVERT DATA: 包含 在 广播 中 的 信息 。 
GAPROLE SCAN RSP DATA: 用 于 回复 主机 扫描 请 求 的 信息 。 
GAPROLE ADVERT OFF TIME: 表示 外 设 关闭 广播 持续 时 间 ， 该 值 为 零 表 示 无 限期 关 
闭 广播 直到 下 一 次 广播 使 能 信号 到 来 。 
> GAPROLE PARAM UPDATE ENABLE: 使 能 自动 更 新 连接 参数 ， 可 以 让 外 设 连 接 失 败 
时 自动 调整 连接 参数 以 便 重 新 连接 。 
> GAPROLE MIN CONN INTERVAL: 设置 最 小 连接 间隙 ， 默 认 值 为 80 个 单位 (每 单位 
125ms) 。 
>  GAPROLE MIN CONN INTERVAL: 设置 最 大 连接 间隙 ， 默 认 值 为 3200 个 单位 。 
> GAPROLE SLAVE LATENCY: 是 一 个 外 设 参数 ， 默 认 值 为 零 。 表 示 处 于 连接 后 ， 从 机 
可 以 做 出 不 响应 连接 请 求 的 距离 数目 ， 即 跳 过 几 个 交互 的 连接 。 
> GAPROLE_TIMEOUT_MULTIPLIER: 最 大 耐心 等 待 时 间 ， 默 认 值 为 1000 个 单位 。 
函数 GAPRole StartDevice 用 来 初始 化 GAP 外 设 和 角色， 其 唯一 的 参数 是 gapRolesCBs t， 这 个 参数 
是 一 个 包含 两 个 函数 指针 的 结构 体 ， 这 两 个 函数 是 pfnStateChange 和 pfnRssiRead， 前 者 标示 状态 ， 后 
者 标示 RSSI 已 经 被 读 走 了 。 
多 角色 同时 扮演 
在 此 以 设备 同时 为 外 设 和 广播 员 两 种 角色 ， 方 法 是 去 除 前 文 外 设 的 定义 剧本 peripheral.c 和 
peripheralh， 添 加 新 的 剧本 peripheralBroadcasterc 和 peripheralBroadcasterh; 定义 处 理 器 值 PLUS 
BROADCASTER。 
GAP 主机 剧本 
与 外 设 剧本 相似 ， 主 机 剧本 的 API 函数 在 central.h 中 定义 ， 包 括 GAPCentralRole_GetParameter 和 
GAPCentralRole SetParameter 以 及 其 他 .如 GAPROLE PARAM UPDATE ENABLE 连接 参数 自动 更 新 
使 能 的 功能 ， 和 外 设 角 色 一 样 。 
GAPCentralRole StartDevice 函数 用 来 初始 化 GAP 主机 角色 ,其 唯一 的 参数 是 gapCentralRolesCBs t, 
这 个 参数 是 一 个 包含 两 个 函数 指针 的 结构 体 ， 这 两 个 函数 是 eventCB 和 rssiCB， 每 次 GAP 时 间 发 生 ， 
前 者 都 会 被 调用 ， 后 者 标示 RSSI 已 经 被 读 走 。 
GAP 绑 定 管理 器 剧本 
GAP 绑 定 管理 器 剧本 用 于 保持 长 期 的 连接 。 同 时 支持 外 设 配置 和 主机 配置 。 当 建立 了 配对 连接 后 ， 
如 果 绑 定 使 能 ， 绑 定 管理 器 就 维护 这 个 连接 。 主 要 参数 如 下 所 示 。 
> GAPBOND PAIRING MODE 
> GAPBOND MITM PROTECTION 
>  GAPBOND IO CAPABILITIES 
>  GAPBOND IO CAP DISPLAY ONLY 
> GAPBOND BONDING ENABLED 
函数 GAPBondMgr Register 用 来 初始 化 GAP 主机 角色 ， 其 唯一 的 参数 是 gapBondCBs t, 3X4 
数 是 一 个 包含 两 个 函数 指针 的 结构 体 ， 这 两 个 函数 是 pairStateCB 和 passcodeCB， 前 者 返回 状态 ， 后 者 
用 于 配对 时 产生 6 位 数字 口令 (passcode). 
М ”编写 一 个 剧本 来 创建 〈 定 义 ) 新 的 角色 〈 功 能 、 服 务 ) 
以 SimpleGATT Profile 为 剧本 名 称 ， 包 含 simpleGATTProfile.c 和 simpleGATTProfile.h 两 个 文件 。 


@ 
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主要 包含 如 下 所 示 的 API 函数 。 
> SimpleProfile AddService: 用 于 初始 化 的 进程 ， 作 用 是 添加 服务 句柄 (serviceattributes) 

到 句柄 组 〈attributetable) 内 ， 寄 存 器 读 取 和 回 写 。 
SimpleProfile SetParameter: 设置 剧本 关键 词 。 
SimpleProfile GetParameter: 获取 设置 剧本 关键 词 。 
SimpleProfile RegisterAppCBs: 注册 simpleProfile 回调 函数 。 
simpleProfile ReadAttrCB: 读 simpleProfile 回调 函数 。 
simpleProfile WriteAttrCB: 写 simpleProfile 回调 函数 。 

>  simpleProfile HandleConnStatusCB: 连接 simpleProfile 状态 函数 。 
此 实例 剧本 共有 如 下 所 示 5 个 关键 词 : 
SIMPLEPROFILE CHARI 
SIMPLEPROFILE CHAR2 
SIMPLEPROFILE CHAR3 
SIMPLEPROFILE CHAR4 
SIMPLEPROFILE_CHARS 

为 节省 本 书 的 篇 幅 , TI 公司 的 低 功 耗 蓝牙 协议 栈 的 基本 知识 介绍 完毕 。 有 关 此 协议 栈 的 具体 知识 ， 
请 读者 登录 其 官方 站 点 查看 帮助 文档 。 
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© 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 4 章 \ 使 用 蓝牙 控制 电 风扇 avi 

本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲解 使 用 蓝牙 技术 传输 数据 的 过 程 。 本 实例 的 功能 是 ， 
使 用 蓝牙 将 Android 应 用 程序 和 风扇 建立 连接 , 在 Android 应 用 程序 中 可 以 设置 一 个 湿度 值 ， 并 根据 设 
置 的 湿度 值 来 控制 风扇 的 转速 。 


本 实例 的 功能 是 使 用 蓝牙 控制 电 风扇 的 转动 ， 在 开始 之 前 使 用 蓝牙 对 Android 应 用 程序 和 电 风 扇 
建立 连接 ，Android 应 用 程序 是 建立 在 Arduino 开发 板 之 上 的 ， 当 然 也 可 以 建立 在 任何 Android 开发 板 
中 ， 也 包括 Android 可 穿戴 设备 。 蓝 牙 、 开 发 板 、 风 扇 的 连接 如 图 4-15 所 示 。 


4-15 ”硬件 设备 的 连接 
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本 实例 的 具体 实现 流程 如 下 所 示 。 

(1) 为 了 降低 开发 成 本 ， 在 本 实例 使 用 的 是 DHT 公司 的 低 端 传感器 产品 。 在 使 用 之 前 ， 需 要 将 
文件 DHT.cpp fll DHT.h 包含 在 Arduino 开发 板 的 库 文 件 夹 的 工程 中 。 其 中 文件 DHTh 是 一 个 头 文件 ， 
功能 是 设置 需要 多 少时 间 进 行 转换 跟踪 ， 有 具体 实现 代码 如 下 : 

#ifndef DHT_H 
#define DHT_H 
#if ARDUINO >= 100 
#include "Arduino.h" 
#else 
#include "WProgram.h" 
#endif 


/* DHT library 


MIT license 
written by Adafruit Industries 
Ji 


#define MAXTIMINGS 85 


#define DHT11 11 
#define DHT22 22 
#define DHT21 21 
#define AM2301 21 


class DHT ( 
private: 
uint8 t data[6]; 
uint8 t pin, type, count; 
boolean read(void); 
unsigned long  lastreadtime; 
boolean firstreading; 


public: 
DHT(uint8 t pin, uint8 t type, uint8 t count=6); 
void begin(void); 
float readTemperature(bool S=false); 
float convertCtoF (float); 
float readHumidity(void); 


k 

#endif 

文件 DHT.cpp 的 功能 是 提供 DHT 的 温度 传感器 和 湿度 传感器 测试 ， 具 体 实现 代码 如 下 : 
#include "DHT.h" 


DHT::DHT(uint8_t pin, uint8 t type, uint8 t count) { 
_pin = pin; 
_type = type; 
_count = count; 
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firstreading = true; 
} 


void DHT::begin(void) { 
/建立 指针 
pinMode(_pin, INPUT); 
digitalWrite(_pin, HIGH); 
_lastreadtime = 0; 


} 


float DHT::readTemperature(bool S) { 
float f; 


if (read()) { 
switch (_type) { 
case DHT11: 
f = data[2]; 
if(S) 
f = convertCtoF(f); 


return f; 
case DHT22: 
case DHT21: 
f = data[2] & Ox7F; 
f *= 256; 
f += data[3]; 
f /= 10; 
if (data[2] & 0x80) 
*=-1; 
if(S) 
f = convertCtoF (f); 


return f; 
} 
} 
Serial.print("Read fail"); 
return NAN; 
} 


float DHT::convertCtoF (float c) { 
return c * 9/5 + 32; 
} 


float DHT::readHumidity(void) { 
float f; 
if (read()) ( 
switch ( type) { 
case DHT11: 
f = data[0]; 
return f; 
case DHT22: 
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case DHT21: 
f = data[0]; 
f *= 256; 
f += data[1]; 
f/= 10; 
return f; 
) 
) 
Serial.print("Read fail"); 
return NAN; 
) 


boolean DHT::read(void) ( 
uint8_t laststate = HIGH; 
uint8_t counter = 0; 
uint8_tj = 0, i; 
unsigned long currenttime; 


// 提 升 指针 ， 并 设置 等 待 250 BH 
digitalWrite(_pin, HIGH); 
delay(250); 


currenttime = millis(); 

if (currenttime < _lastreadtime) { 
// 此 时 翻转 
_lastreadtime = 0; 


if (!firstreading && ((currenttime - _lastreadtime) < 2000)) { 
return true; //return last correct measurement 
lidelay(2000 - (currenttime - lastreadtime)); 

} 

firstreading = false; 

r 
Serial.print("Currtime: "); Serial.print(currenttime); 
Serial.print(" Lasttime: "); Serial.print( lastreadtime); 

' 

_lastreadtime = millis(); 


data[0] = data[1] = data[2] = data[3] = data[4] = 0; 


ШПНЕ 20 毫秒 
pinMode(_pin, OUTPUT); 
digitalWrite(_pin, LOW); 
delay(20); 

cli(); 

digitalWrite( pin, HIGH); 
delayMicroseconds(40); 
pinMode( pin, INPUT); 


// 读 取 时 间 
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for ( i=0; i< MAXTIMINGS; i++) { 
counter = 0; 
while (digitalRead(_pin) == laststate) { 
counter++; 
delayMicroseconds(1); 
if (counter == 255) { 
break; 


h 
} 
laststate = digitalRead(_pin); 
if (counter == 255) break; 


/忽略 前 3 个 转换 
if (i >= 4) && (i%2 == 0)) ( 
data[j/8] <<= 1; 
if (counter > count) 
data[j/8] |= 1; 
[єк 


} 
} 
sei(); 


r 
Serial.printin(j, DEC); 

Serial.print(data[0], HEX); Serial.print(", "); 
Serial.print(data[1], HEX); Serial.print(", "); 
Serial.print(data[2], HEX); Serial.print(", "); 
Serial.print(data[3], HEX); Serial.print(", "); 
Serial.print(data[4], HEX); Serial.print(" =? "); 
Serial.printin(data[0] + data[1] + data[2] + data[3], HEX); 
" 


// 读 取 到 40 位 便 进行 校 验 并 比较 
if (j >= 40) && 
(data[4] == ((data[0] + data[1] + data[2] + data[3]) & OxFF)) ) { 
return true; 


} 


return false; 


} 
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编写 测试 程序 DHTtester.pde 来 获取 DHT 传感器 温度 和 湿度 值 ， 具 体 实现 代码 如 下 : 


DHT dht(DHTPIN, ОНТТҮРЕ); 


void setup() { 
Serial.begin(9600); 
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Serial.printin("DHTxx test!"); 


dht.begin(); 
} 


void loop() { 
float h = dht.readHumidity(); 
float t = dht.readTemperature(); 


if (isnan(t) || isnan(h)) { 
Serial.printin("Failed to read from DHT"); 
) else { 
Serial.print("Humidity: "); 
Serial.print(h); 
Serial.print(" %\t"); 
Serial.print("Temperature: "); 
Serial.print(t); 
Serial.printin(" *C"); 
} 
} 
(2) 开始 编写 Android 应 用 程序 ， 首 先 编写 界面 布局 文件 activity_controlxml， 功 能 是 设置 蓝牙 启 
动 测试 按钮 ， 具 体 实现 代码 如 下 : 
<RelativeLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
xmins:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 


android:layout height-"match parent" 
> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:paddingBottom-"(gdimen/activity vertical margin" 
android:paddingLeft-"(odimen/activity horizontal margin" 
android:paddingRight-"(dimen/activity horizontal margin" 
android:paddingTop-"(Qdimen/activity vertical margin" 
tools:context=".ControlActivity" > 


<TextView 
android:id="@+id/textView1" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:layout alignParentTop-"true" 
android:layout_marginLeft="17dp" 
android:layout_marginTop="15dp" 
android:text=""_/> 


<Button 
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android:id="@+id/connect" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout_alignLeft="@+id/textView1" 
android:layout_below="@+id/textView1" 
android:layout_marginTop="10dp" 
android:text="Connect" 
android:layout_gravity="center" /> 


<ImageView 
android:id="@+id/power_button" 
android:layout_width="130dp" 
android:layout_height="130dp" 
android:contentDescription="@string/power_control" 
android:src="@drawable/humidigator_off" 
android:layout_gravity="center_horizontal" 
android:layout_weight="7" /> 
<TextView 
android:id-"(g*id/current data" 
android:layout width-"wrap content" 
android:layout_height="36dp" 
android:layout_marginTop="69dp" 
android:layout_gravity="center_horizontal" 
android:gravity="center_horizontal" 
android:textSize="16sp" 
android:textColor="@color/white" 
android:text="Press 'Connect' to connect to Humidigator" /> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:layout_weight="12" 
android:layout_marginBottom="20dp" 

> 


<LinearLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
android:gravity-"center" 
android:id="@+id/setHumLayout" 
> 


<TextView 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:text="Set Humidity" 
android:textSize-"30dp" 
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android:textColor="@color/white" 

android:textStyle-"normal" 

android:layout marginRight-"15dp" 
I 


«TextView 
android:id="@+id/humidity" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"50" 
android:textSize-"30dp" 
android:layout marginTop-"3dp" 
android:textColor="@color/white" 
android:layout_gravity="center_vertical" /> 
<TextView 
android:gravity-"center" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:text="%" 
android:textSize="30dp" 
android:layout marginTop-"3dp" 
android:textColor="@color/white" 
android:layout_gravity="center_vertical" 
> 


</LinearLayout> 


<SeekBar 
android:id="@+id/humidity_seek" 

android:layout_width="300dp" 
android:layout height-"wrap content" 
android:layout gravity-"center" 
android:progress-"50" 

> 
</LinearLayout> 
</LinearLayout> 
</RelativeLayout> 


然后 编写 主 Android 应 用 程序 文件 ControlActivityjava， 功 


P] 
ВЕЕ 


根据 用 户 触摸 屏幕 操作 来 开启 关闭 


蓝牙 测试 开关 ， 将 用 户 设置 的 值 通过 蓝牙 传递 给 DHT 传感器 程序 以 控制 电 风扇 的 转动 。 文 件 


ControlActivity.java 的 具体 实现 代码 如 下 : 


public class ControlActivity extends Activity implements OnClickListener, OnSeekBarChangeListener{ 


Button Connect; 
ToggleButton OnOff, 
TextView Result; 

private String dataToSend; 
boolean powerOn = false; 


private static final String TAG = "lan"; 
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private BluetoothAdapter mBluetoothAdapter = null; 

private BluetoothSocket btSocket = null; 

private OutputStream outStream = null; 

private static String address = "20:13:08:28:03:16"; 

private static final UUID MY_UUID = UUID 
.fromString("00001 101-0000-1000-8000-00805F9B34FB"); 

private InputStream inStream = null; 

Handler handler = new Handler(); 

byte delimiter = 10; 

boolean stopWorker = false; 

int readBufferPosition = 0; 

byte[] readBuffer = new byte[1024]; 


private TextView setHum; 
private SeekBar humSeek; 
private LinearLayout setHumLayout; 


ImageView powerButton; 


@Override 

protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity_control); 


CheckBt(); 
BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address); 
Log.e("lan", device.toString()); 


Connect = (Button) findViewByld(R.id.connect); 

powerButton = (ImageView) findViewByld(R.id.power_button); 
Result = (TextView) findViewByld(R.id.current_data); 

setHum = (TextView) findViewByld(R.id.humidity); 

humSeek = (SeekBar) findViewByld(R.id.humidity_seek); 
setHumLayout = (LinearLayout) findViewByld(R.id.setHumLayout); 


Connect.setOnClickListener(this); 
powerButton.setOnClickListener(this); 
humSeek.setOnSeekBarChangeListener(this); 


powerButton.setVisibility(View.INVISIBLE); 


setHumLayout.setVisibility(View.INVISIBLE); 
humSeek.setVisibility(View.INVISIBLE); 


} 


private void CheckBt() { 
mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter(); 


if (ImBluetoothAdapter.isEnabled()) { 
Toast.makeText(getApplicationContext(), "Bluetooth Disabled !", 


137 


= 


E Android 物 联网 开发 从 入 门 到 实战 


} 


Toast.LENGTH_SHORT).show(); 


if (mBluetoothAdapter == null) { 


Toast.makeText(getApplicationContext(), 
"Bluetooth null !", Toast. LENGTH_SHORT) 
.show(); 


public void Connect() ( 


} 


Log.d(TAG, address); 
BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address); 
Log.d(TAG, "Connecting to ... " + device); 
mBluetoothAdapter.cancelDiscovery(); 
ty{ 
btSocket = device.createRfcommSocketToServiceRecord(MY_UUID); 
btSocket.connect(); 
Log.d(TAG, "Connection made."); 
} catch (IOException e) ( 


btSocket.close(); 
} catch (IOException e2) ( 
Log.d(TAG, "Unable to end the connection"); 


) 
Log.d(TAG, "Socket creation failed"); 
} 


beginListenForData(); 


private void writeData(String data) { 


try { 


outStream = btSocket.getOutputStream(); 


} catch (IOException e) { 


} 


Log.d(TAG, "Bug BEFORE Sending stuff", е); 


String message = data; 
byte[] msgBuffer = message.getBytes(); 


try ( 
outStream.write(msgBuffer); 
} catch (IOException e) ( 
Log.d(TAG, "Bug while sending stuff", e); 
} 
} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
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try ( 
btSocket.close(); 
} catch (IOException e) { 
} 
} 
public void beginListenForData() { 
ty{ 
inStream = btSocket.getInputStream(); 
) catch (IOException e) ( 
) 


Thread workerThread = new Thread(new Runnable() 
public void run() 


while(!Thread.currentThread().isInterrupted() && !stopWorker) 


{ 
try 


int bytesAvailable = inStream.available(); 
if(bytesAvailable > 0) 


byte[] packetBytes = new byte[bytesAvailable]; 
inStream.read(packetBytes); 
for(int i=0;i<bytesAvailable;i++) 


{ 
byte b = packetBytes[i]; 
if(b == delimiter) 
{ 
byte[] encodedBytes = new byte[readBufferPosition]; 
System arraycopy(readBuffer, 0, encodedBytes, 0, encodedBytes length); 
final String data = new String(encodedBytes, "US-ASCII"); 
readBufferPosition = 0; 
handler.post(new Runnable() 
{ 
public void run() 
{ 
Result.setText(data); 
Result.setTextSize(25); 
} 
}); 
} 
else 
{ 
readBuffer[readBufferPosition++] = b; 
} 
} 
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} 
} 
catch (IOException ex) 
{ 
stopWorker = true; 
} 
} 
} 
}; 
workerThread.start(); 
} 
@Override 


public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.control, menu); 
return true; 


} 


@Override 
public void onClick(View control) { 
switch (control.getld()) { 
case R.id.connect: 
Connect(); 
powerButton.setVisibility(View. VISIBLE); 
setHumLayout.setVisibility(View. VISIBLE); 
humSeek.setVisibility(View. VISIBLE); 


Connect.setVisibility(View. INVISIBLE); 
break; 
case R.id.power_button: 
if (lpowerOn){ 
powerOn = true; 
powerButton.setlmageResource(R.drawable.humidigator on); 
dataToSend = "1"; 


writeData(dataToSend); 
} 
else if (powerOn){ 
powerOn = false; 
powerButton.setlmageResource(R.drawable.humidigator off); 
dataToSend = "0"; 
writeData(dataToSend); 
) 
break; 
} 
jj 
@Override 


public void onProgressChanged(SeekBar seekBar, int progress, 
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boolean fromUser) ( 
setHum.setText(Integer.toString(humSeek.getProgress())); 
} 


@Override 

public void onStartTrackingTouch(SeekBar seekBar) { 
} 

@Override 

public void onStopTrackingTouch(SeekBar seekBar) { 
} 


} 
至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 4-16 所 示 。 


Set Humidity: 50% 


4-16 执行 效果 


本 实例 的 目的 是 演示 通过 蓝牙 和 传感器 设备 控制 硬件 的 过 程 ， 这 说 明 蓝 牙 技 术 在 近 距 离 传输 中 的 
作用 ， 所 以 必然 被 可 穿戴 设备 广泛 接收 并 支持 。 


第 5 章 Android 蓝牙 系统 详解 


Android 系统 包含 了 对 蓝牙 网 络 协议 栈 的 支持 , 这 使 得 蓝牙 设备 能 够 无 线 连接 其 他 蓝牙 设备 交换 数 
据 。Android 的 应 用 程序 框架 提供 了 访问 蓝牙 功能 的 APIs。 这 些 APIs 让 应 用 程序 能 够 无 线 连接 其 他 蓝 
牙 设备 ， 实 现 点 对 点 ， 或 点 对 多 点 的 无 线 交 互 功 能 。 本 章 将 首先 讲解 Android 系统 中 蓝牙 模块 的 基本 
知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


51 Android 系统 中 的 蓝牙 模块 


GU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 5 章 \Android 系统 中 的 蓝牙 模块 .avi 

Android 平台 的 蓝牙 系统 是 基于 Bluez 实现 的 ,是 通过 Linux 中 一 套 完整 的 蓝牙 协议 栈 开 源 实现 的 。 
当前 Bluez 被 广泛 应 用 于 各 种 Linux 版 本 中 , 并 被 芯片 公司 移植 到 各 种 芯片 平台 上 所 使 用 ,在 Linux 2.6 
内 核 中 已 经 包含 了 完整 的 Bluez 协议 栈 ， 在 Android 系统 中 已 经 移植 并 嵌入 进 了 Bluez 的 用 户 空间 实 
现 ， 并 且 随 着 硬件 技术 的 发 展 而 不 断 更 新 。 

HF (Bluetooth) 技术 实际 上 是 一 种 短 距 离 无 线 电 技术 。 在 Android 系统 的 蓝牙 模块 中 ， 除 了 使 
用 Kernel 支持 外 ， 还 需要 用 户 空间 的 BlueZ 支持 。 

Android 平台 中 蓝牙 模块 的 基本 层次 结构 如 图 5-1 所 示 。 


蓝牙 应 用 平台 API 


S2 
Android, Bluetooth 
db Android RY 


本 地 框架 Bluetooth JNI 
Bluetooth 适 配 层 和 BlueZ 库 


本 地 框架 


蓝牙 设备 硬件 和 驱动 


5-1 蓝牙 系统 的 层次 结构 


Android 平台 中 蓝牙 系统 从 上 到 下 主要 包括 Java 框架 中 的 BlueTooth 类 、Android 适 配 库 、BlueZ 
库 、 驱 动 程序 和 协议 ， 其 系统 结构 如 图 5-2 所 示 。 
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52 ”蓝牙 系统 结构 


在 图 5-2 中 各 个 层次 结构 的 具体 说 明 如 下 。 
(1) BlueZ 库 
Android 蓝牙 设备 管理 的 库 的 路 径 是 external/bluez/. 
可 以 分 别 生 成 库 libbluetooth.so、libbluedroid.so 和 hcidump 等 众多 相关 工具 和 库 。BlueZ 库 提供 了 
对 用 户 空间 蓝牙 的 支持 ， 在 里 面包 含 了 主机 控制 协议 НСІ 以 及 其 他 众多 内 核实 现 协 议 的 接口 ， 并 且 实 
现 了 所 有 蓝牙 应 用 模式 Profile。 
(2) 蓝牙 的 JNI 部 分 
此 部 分 的 代码 路 径 是 frameworks/base/core/jni/. 
(3) Java 框架 层 
Java 框架 层 的 实现 代码 保存 在 如 下 路 径 中 。 
E frameworks/base/core/java/android/bluetooth: 蓝牙 部 分 对 应 应 用 程序 的 API, 
frameworks/base/core/java/android/Server: 蓝牙 的 服务 部 分 。 
蓝牙 的 服务 部 分 负责 管理 并 使 用 底层 本 地 服务 ， 并 封装 成 系统 服务 。 而 在 android.bluetooth 部 分 中 
包含 了 各 个 蓝牙 平台 的 API 部 分 ， 以 供应 用 程序 层 所 使 用 。 
(4) BlueTooth 的 适 配 库 
BlueTooth 适 配 库 的 代码 路 径 是 system/bluetooth/。 
该 层 用 于 生成 库 libbluedroid.so 以 及 相关 工具 和 库 ， 能 够 实现 对 蓝牙 设备 的 管理 , 例如 蓝牙 设备 的 
电源 管理 。 


52 分 析 蓝 牙 模块 的 源码 


茵 "知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 5 章 \ 分 析 蓝 牙 模块 的 源码 .avi 
要 想 掌 握 蓝 牙 系统 的 开发 原理 ， 需 要 首先 分 析 Android 中 的 蓝牙 源码 并 了 解 其 核心 构造 ， 只 有 这 
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样 才能 对 蓝牙 应 用 开发 做 到 游 轧 有余。 本 节 将 简要 介绍 开源 Android 中 蓝牙 模块 相关 的 代码 ， 为 读者 
步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


524 初始 化 蓝牙 芯片 


初始 化 蓝牙 芯片 工作 是 通过 Bluez 工具 heiattach 进行 的 ， 此 工具 在 external/bluetooth/tools 目录 的 
文件 中 实现 。 

hciattach 命令 主要 用 来 初始 化 蓝牙 设备 ， 它 的 命令 格式 如 下 : 

hciattach [-n] [-p] [-b] [-t timeout] [-s initial_speed] <tty> <type | id> [speed] [flow|noflow] [bdaddr] 

在 上 述 格式 中 ， 最 重要 的 参数 就 是 type 和 speed, type 决定 了 要 初始 化 的 设备 的 型 号 ， 可 以 使 用 
heciattach-1 来 列 出 所 支持 的 设备 型 号 。 

并 不 是 所 有 的 参数 对 所 有 的 设备 都 是 适用 的 ， 有 些 设备 会 忽略 一 些 参数 设置 , 例如 ,查看 hciattach 
的 代码 就 可 以 看 到 ， 多 数 设 备 都 忽略 bdaddr 参数 。hciattach 命令 内 部 的 工作 步骤 是 : 首先 打开 制定 的 
tty 设备 ， 然 后 做 一 些 通用 的 设置 ， 如 flow 等 ， 接 着 设置 波 特 率 为 initial speed， 然 后 再 根据 type 调用 
各 自 的 初始 化 代码 ， 最 后 将 波 特 率 重新 设置 为 speed。 所 以 调用 hciattach 时 ， 要 根据 实际 情况 设置 
initial speed 和 speed. 

对 于 type BCSP 来 说 ， 它 的 初始 化 代码 只 做 了 一 件 事 ， 就 是 完成 BCSP 协议 的 同步 操作 ， 它 并 不 
对 蓝牙 芯片 做 任何 的 pskey 设置 。 


522 ”蓝牙 服务 
在 蓝牙 服务 方面 一 般 不 要 我 们 自己 定义 ， 只 需要 使 用 初始 化 脚本 文件 initre 中 的 默认 内 容 即 可 。 
例如 下 面 的 代码 。 


service bluetoothd /system/bin/logwrapper /system/bin/bluetoothd -d -n 
socket bluetooth stream 660 bluetooth bluetooth 
Socket dbus bluetooth stream 660 bluetooth bluetooth 
# init.rc does not yet support applying capabilities, so run as root and 
3t let bluetoothd drop uid to bluetooth with the right linux capabilities 
group bluetooth net bt admin misc 
disabled 


# baudrate change 115200 to 1152000(Bluetooth) 
service changebaudrate /system/bin/logwrapper /system/xbin/bccmd 115200 -t besp -d /dev/s3c2410 serial1 
psset -r Ox1be 0x126e 

user bluetooth 

group bluetooth net bt admin 

disabled 

oneshot 


#service hciattach /system/bin/logwrapper /system/bin/hciattach -n -s 1152000 /dev/s3c2410 serial bcsp 
1152000 
service hciattach /system/bin/logwrapper /system/bin/hciattach -n -s 115200 /dev/s3c2410 serial1 bcsp 115200 
user bluetooth 
group bluetooth net bt admin misc 
disabled 


service hfag /system/bin/sdptool add —channel-10 HFAG 
user bluetooth 
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group bluetooth net_bt_admin 
disabled 
oneshot 


service hsag /system/bin/sdptool add --channel=11 HSAG 
user bluetooth 
group bluetooth net_bt_admin 
disabled 
oneshot 


service opush /system/bin/sdptool add --channel=12 OPUSH 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


service pbap /system/bin/sdptool add --channel=19 PBAP 
user bluetooth 
group bluetooth net bt admin 
disabled 
oneshot 


在 上 述 代 码 中 ， 每 一 个 service 后 面 都 列 出 了 一 种 Android 服务 。 
523 ”管理 蓝牙 电源 


在 Android 系统 的 软件 目录 system/bluetooth/ 中 实现 了 libbluedroid。 


可 以 调用 rfkill 接口 来 控制 电源 管理 ， 如 果 已 经 实现 了 rfkill 接口 ， 则 无 须 再 进行 配置 。 如 果 在 文 
fF initrc 中 已 经 实现 了 heiattach 服务 , 则 说 明 在 libbluedroid 中 已 经 实现 对 其 调用 以 操作 蓝牙 的 初始 化 。 


53 ”和 蓝牙 相关 的 类 
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经 过 本 章 前 面 内容 的 学 习 ， 已 经 了 解 了 Android 系统 中 蓝牙 的 基本 知识 。 


根据 对 上 述 从 底层 到 应 


用 的 学 习 ， 了 解 了 蓝牙 的 工作 原理 和 机 制 。 本 节 将 详细 讲解 在 Android 系统 中 和 蓝牙 相关 的 类 ， 为 读 


者 步 入 本 书后 面 知识 的 学 习 打 好 基础 。 
5.3.1 BluetoothSocket 类 


1. BluetoothSocket 类 基础 


类 BluetoothSocket 的 定义 格式 如 下 : 

public static class Gallery.LayoutParams extends ViewGroup.LayoutParams 
类 BluetoothSocket 的 定义 结构 如 下 : 

java.lang.Object 

android.view. ViewGroup.LayoutParams 
android.widget.Gallery.LayoutParams 


Android 的 蓝牙 系统 和 Socket 套 接 字 密 切 相 关 ， 蓝 牙 端 的 监听 接口 和 TCP 的 端口 类 似 ， 都 是 使 用 


Был 


了 Socket 和 ServerSocket 类 。 在 服务 器 端 ， 使 用 BluetoothServerSocket 类 来 创建 一 个 监听 服务 端口 。 
当 一 个 连接 被 BluetoothServerSocket 所 接受 ， 它 会 返回 一 个 新 的 BluetoothSocket 来 管理 该 连接 。 在 客 
户 端 ， 使 用 一 个 单独 的 BluetoothSocket 类 去 初始 化 一 个 外 接连 接 和 管理 该 连接 。 

最 通常 使 用 的 蓝牙 端口 是 RFCOMM， 它 是 被 Android АРІ 支持 的 类 型 。RFCOMM 是 一 个 面向 连 
接 ， 通 过 蓝牙 模块 进行 的 数据 流传 输 方式 ， 它 也 被 称 为 串 行 端口 规范 (Serial Port Profile, SPP). 

为 了 创建 一 个 BluetoothSocket 去 连接 到 一 个 已 知 设备 ， 使 用 方法 BluetoothDevice.createRfcomm 
SocketToServiceRecord()。 然 后 调用 connect0 方 法 去 尝试 一 个 面向 远程 设备 的 连接 。 这 个 调用 将 被 阻塞 
指导 一 个 连接 已 经 建立 或 者 该 链接 失效 。 

为 了 创建 一 个 BluetoothSocket 作为 服务 端 (或 者 “主机 ”)， 每 当 该 端口 连接 成 功 后， 无 论 它 初始 
化 为 客户 端 ， 或 者 被 接收 作为 服务 端 ， 都 通过 方法 getInputStream() Fil getOutputStream0) 来 打开 VO 流 ， 
从 而 获得 各 自 的 InputStream 和 OutputStream 对 象 

BluetoothSocket 类 的 线程 是 安全 的 ， 因 为 close0 方 法 总 会 马上 放弃 外 界 操 作 并 关闭 服务 端口 。 


2. BluetoothSocket 类 的 公共 方法 


(1) public void close() 

功能 : 马上 关闭 该 端口 并 且 释 放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 从 而 使 系统 
马上 抛 出 一 个 IO 异常 。 

У: IOException. 

(2) public void connect() 

功能 : 尝试 连接 到 远程 设备 。 该 方法 将 阻塞 ， 指 导 一 个 连接 建立 或 者 失效 。 如 果 该 方法 没有 返回 
异常 值 ， 则 该 端口 现在 已 经 建立 。 当 设备 查找 正在 进行 时 ， 创 建 对 远程 蓝牙 设备 的 新 连接 不 可 被 尝试 。 
设备 查找 在 蓝牙 适配器 上 是 一 个 重量 级 过 程 ， 并 且 肯 定 会 降低 一 个 设备 的 连接 。 使 用 cancelDiscovery() 
方法 会 取消 一 个 外 界 的 查询 ， 因 为 这 个 查询 并 不 由 活动 所 管理 ， 而 是 作为 一 个 系统 服务 来 运行 ， 所 以 
即使 它 不 能 直接 请 求 一 个 查询 ， 应 用 程序 也 总 会 调用 cancelDiscovery0 方 法 。 使 用 方法 close0 可 以 用 来 
放弃 从 另 一 线程 而 来 的 调用 。 

异常 : IOException， 表 示 一 个 错误 ， 例 如 连接 失败 。 

(3) public InputStream getInputStream() 

功能 : 通过 连接 的 端口 获得 输入 数据 流 。 即 使 该 端口 未 连接 ， 该 输入 数据 流 也 会 返回 。 不 过 在 该 
数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输入 流 。 

Sei: IOException. 

(4) public OutputStream getOutputStream() 

功能 : 通过 连接 的 端口 获得 输出 数据 流 。 即 使 该 端口 未 连接 ， 该 输出 数据 流 也 会 返回 。 不 过 在 该 
数据 流 上 的 操作 将 抛 出 异常 ， 直 到 相关 的 连接 已 经 建立 。 

返回 值 : 输出 流 。 

异常 : IOException. 

(5) public BluetoothDevice getRemoteDevice() 

功能 : 获得 该 端口 正在 连接 或 者 已 经 连接 的 远程 设备 。 

返回 值 : 远程 设备 。 


(uo, 
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5.3.2 BluetoothServerSocket Ж 


1. BluetoothServerSocket 类 基础 


Ж BluetoothServerSocket 的 格式 如 下 : 
public final class BluetoothServerSocket extends Object implements Closeable 
类 BluetoothServerSocket 的 结构 如 下 : 


java.lang.Object 
android.bluetooth.BluetoothServerSocket 


2. BluetoothServerSocket 类 的 公共 方法 


(1) public BluetoothSocketaccept(int timeout) 
功能 : 阻塞 直到 超时 时 间 内 的 连接 建立 。 在 一 个 成 功 建立 的 连接 上 返回 一 个 已 连接 的 
BluetoothSocket 类 。 每 当 该 调用 返回 时 ， 它 可 以 在 此 调用 去 接收 以 后 新 来 的 连接 。close() 方 法 可 以 用 来 
放弃 从 另 一 线程 来 的 调用 。 
参数 timeout: 表示 阻塞 超时 时 间 。 
返回 值 : 已 连接 的 BluetoothSocket。 
异常 : IOException， 表 示 出 现 错误 ， 例 如 该 调用 被 放弃 或 超时 。 
(2) public BluetoothSocket acceptO 
功能 : 阻塞 直到 一 个 连接 已 经 建立 。 在 一 个 成 功 建立 的 连接 上 返回 一 个 已 连接 的 BluetoothSocket 
类 。 每 当 该 调用 返回 时 ， 它 可 以 在 此 调用 去 接收 以 后 新 来 的 连接 。 使 用 close0 方 法 可 以 用 来 放弃 从 另 
一 线程 来 的 调用 。 
返回 值 : 已 连接 的 BluetoothSocket。 
异常 : IOException， 表 示 出 现 错误 ， 例 如 该 调用 被 放弃 或 者 超时 。 
(3) public void close() 
功能 : 马上 关闭 端口 ， 并 释放 所 有 相关 的 资源 。 在 其 他 线程 的 该 端口 中 引起 阻塞 ， 从 而 使 系统 马 
上 抛 出 一 个 IO 异常 。 关 闭 BluetoothServerSocket 不 会 关闭 接受 自 acceptO 的 任意 BluetoothSocket。 
异常 : IOException。 


5.3.3 BluetoothAdapter 类 


1. BluetoothAdapter 类 基础 


类 BluetoothAdapter 的 格式 如 下 : 
public final class BluetoothAdapter extends Object 


类 BluetoothAdapter 的 结构 如 下 : 

java.lang.Object 

android.bluetooth.BluetoothAdapter 

BluetoothAdapter 代表 本 地 的 蓝牙 适配器 设备 ， 通 过 此 类 可 以 让 用 户 执行 基本 的 蓝牙 任务 。 例 如 初 
始 化 设备 的 搜索 ,查询 可 匹配 的 设备 集 ， 使 用 一 个 已 知 的 MAC 地 址 来 初始 化 一 个 BluetoothDevice Ж, 
创建 一 个 BluetoothServerSocket 类 以 监听 其 他 设备 对 本 机 的 连接 请 求 等 。 

为 了 得 到 这 个 代表 本 地 蓝牙 适配器 的 BluetoothAdapter 类 , 需要 调用 静态 方法 getDefaultAdapter(), 
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这 是 所 有 蓝牙 动作 使 用 的 第 一 步 。 当 拥有 本 地 适配器 以 后 ， 用 户 可 以 获得 一 系列 的 BluetoothDevice 对 
象 ， 这 些 对 象 代表 所 有 拥有 getBondedDevice( 方 法 的 已 经 匹配 的 设备 ; 用 startDiscovery() 方 法 来 开始 
设备 的 搜寻 ; 或 者 创建 一 个 BluetoothServerSocket 25, 通过 listenUsingRfcommWithServiceRecord(String, 
UUID) 方 法 来 监听 新 来 的 连接 请 求 。 


注意 : 大 部 分 方法 需要 BLUETOOTH 权限 ， 一 些 方法 同时 需要 BLUETOOTH ADMIN 权限 。 
2. BluetoothAdapter 类 的 常量 


(1) String ACTION DISCOVERY FINISHED 
广播 事件 : 本 地 蓝牙 适配器 已 经 完成 设备 的 搜寻 过 程 。 需 要 BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapter.action.DISCOVERY FINISHED. 
(2) String ACTION DISCOVERY STARTED 
广播 事件 : 本 地 蓝牙 适配器 已 经 开始 对 远程 设备 的 搜寻 过 程 。 它 通常 牵涉 到 一 个 大 概 需 时 12 秒 的 
查询 扫描 过 程 ， 紧 跟着 是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫描 。 用 户 会 发 现 一 个 把 
ACTION FOUND 常量 通知 为 远程 蓝牙 设备 的 注册 。 设 备查 找 是 一 个 重量 级 过 程 。 当 查找 正在 进行 时 ， 
用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 
用 户 可 用 cancelDiscovery0 类 来 取消 正在 执行 的 查找 进程 。 需 要 BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapter.action.DISCOVERY_STARTED。 
(3) String ACTION LOCAL NAME CHANGED 
广播 活动 : 本 地 蓝牙 适配器 已 经 更 改 了 它 的 蓝牙 名 称 。 该 名 称 对 远程 蓝牙 设备 是 可 见 的 ， 它 总 是 
包含 了 一 个 带 有 名 称 的 EXTRA_LOCAL_NAME 附加 域 。 需 要 BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapteractionLOCAL NAME CHANGED. 
(4) String ACTION REQUEST DISCOVERABLE 
Activity 活动 : 显示 一 个 请 求 被 搜寻 模式 的 系统 活动 。 如 果 蓝 牙 模 块 当前 未 打开 ， 该 活动 也 将 请 求 
用 户 打开 蓝牙 模块 。 被 搜寻 模式 和 SCAN MODE CONNECTABLE DISCOVERABLE 等 价 。 当 远程 设 
备 执行 查找 进程 时 ， 它 允许 其 发 现 该 蓝牙 适配器 。 从 隐私 安全 考虑 ，Android 不 会 将 被 搜寻 模式 设置 为 
默认 状态 。 该 意图 的 发 送 者 可 以 选择 性 地 运用 EXTRA_DISCOVERABLE_DURATION 这 个 附加 域 去 请 
求 发 现 设备 的 持续 时 间 。 普 遍 来 说 ， 对 于 每 一 请 求 ， 默 认 的 持续 时 间 为 120 秒 ， 最 大 值 则 可 达到 300 秒 。 
Android 运用 onActivityResult(int, int, Intent) 回 收 方法 来 传递 该 活动 结果 的 通知 。 被 搜寻 的 时 间 (以 
秒 为 单位 ) 将 通过 resultCode 值 来 显示 ， 如 果 用 户 拒绝 被 搜寻 ， 或 者 设备 产生 了 错误 ， 则 通过 
RESULT CANCELED 值 来 显示 。 
每 当 扫 描 模式 变化 时 ， 应 用 程序 可 以 通过 ACTION SCAN MODE CHANGED 值 来 监听 全 局 的 消 
息 通 知 。 例 如 ， 当 设备 停止 被 搜寻 以 后 , 该 消息 可 以 被 系统 通知 给 应 用 程序 。 需 要 BLUETOOTH 权限 。 
常量 值 : android.bluetooth.adapter.action.REQUEST_DISCOVERABLE。 
(5) String ACTION REQUEST ENABLE 
Activity 活动 : 显示 一 个 允许 用 户 打开 蓝牙 模块 的 系统 活动 。 当 蓝牙 模块 完成 打开 工作 ,或 者 当 用 
户 决定 不 打开 蓝牙 模块 时 ， 系 统 活动 将 返回 该 值 。Android 运用 onActivityResult(int, int, Intent) 回 收 方 
法 来 传递 该 活动 结果 的 通知 。 如 果 蓝 牙 模块 被 打开 ， 将 通过 resultCode (ñ RESULT OK 来 显示 ; ШЖ 
用 户 拒绝 该 请 求 ， 或 者 设备 产生 了 错误 ， 则 通过 RESULT CANCELED 值 来 显示 。 每 当 蓝牙 模块 被 打 
开 或 者 关闭 ， 应 用 程序 可 以 通过 ACTION STATE CHANGED 值 来 监听 全 局 的 消息 通知 。 需 要 
BLUETOOTH 权限 。 
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常量 值 : android.bluetooth.adapter.action REQUEST ENABLE. 
(6) String ACTION SCAN MODE CHANGED 
广播 活动 : 指明 蓝牙 扫描 模块 或 者 本 地 适配器 已 经 发 生变 化 。 它 总 是 包含 EXTRA SCAN MODE 
和 EXTRA PREVIOUS SCAN MODE. 。 这 两 个 附加 域 各 自 包 含 了 新 的 和 旧 的 扫描 模式 。 需 要 
BLUETOOTH 权限 。 
常量 值 : android.bluetooth.adapter.action.SCAN MODE CHANGED. 
(7) String ACTION STATE CHANGED 
广播 活动 : 本 来 的 蓝牙 适配器 的 状态 已 经 改变 ， 例 如 蓝牙 模块 已 经 被 打开 或 者 关闭 。 它 总 是 包含 
EXTRA STATE 和 EXTRA PREVIOUS STATE. 。 这 两 个 附加 域 各 自 包含 了 新 的 和 旧 的 状态 。 需 要 
BLUETOOTH 权限 接收 。 
常量 值 : android.bluetooth.adapter.action.STATE CHANGED. 
(8) int ERROR 
功能 : 标记 该 类 的 错误 值 。 确 保 和 该 类 中 的 任意 其 他 整数 常量 不 相等 。 它 为 需要 一 个 标记 错误 值 
的 函数 提供 了 便利 。 例 如 : 
Intent.getintExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR) 
常量 值 : -2147483648(0x80000000). 
(9) String EXTRA DISCOVERABLE DURATION 
功能 : 试图 在 ACTION REQUEST DISCOVERABLE 常量 中 作为 一 个 可 选 的 整 型 附加 域 ， 来 为 短 
时 间 内 的 设备 发 现 请 求 一 个 特定 的 持续 时 间 。 默 认 值 为 120 秒 ， 超 过 300 秒 的 请 求 将 被 限制 。 这 些 值 
是 可 以 变化 的 。 
常量 值 :android.bluetooth.adapter.extra.DISCOVERABLE_DURATION。 
(10) String EXTRA LOCAL NAME 
功能 : 试图 在 ACTION LOCAL NAME CHANGED 常量 中 作为 一 个 字符 串 附加 域 ， 来 请 求 本 地 
蓝牙 的 名 称 。 
常量 值 : android.bluetooth .adapterextra LOCAL МАМЕ. 
(11) String EXTRA PREVIOUS SCAN MODE 
功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 以 前 的 扫 
描 模式 。 可 以 取 的 值 如 下 : 
回 SCAN MODE NONE 
М SCAN MODE CONNECTABLE 
回 SCAN MODE CONNECTABLE DISCOVERABLE 
常量 值 : android.bluetooth.adapter.extra PREVIOUS SCAN МОРЕ. 
(12) String EXTRA PREVIOUS STATE 
功能 : 试图 在 ACTION STATE CHANGED 常量 中 作为 一 个 整 型 附加 域 , 来 请 求 以 前 的 供电 状态 。 
可 以 取 的 值 如 下 : 
回 STATE OFF 
STATE TURNING ON 
STATE ON 
STATE TURNING OFF 


ndroid 物 联网 开发 从 入 门 到 实战 

常量 值 : android.bluetooth.adapter.extra. PREVIOUS STATE. 

(13) String EXTRA SCAN MODE 

功能 : 试图 在 ACTION SCAN MODE CHANGED 常量 中 作为 一 个 整 型 附加 域 ， 来 请 求 当 前 的 扫 
描 模式 ， 可 以 取 的 值 如 下 : 

SCAN MODE NONE 

М SCAN MODE CONNECTABLE 

SCAN MODE CONNECTABLE DISCOVERABLE 

常量 值 : android.bluetooth.adapter.extra.SCAN MODE. 

(14) String EXTRA STATE 

功能 : 试图 在 ACTION_STATE_CHANGED 常量 中 作为 一 个 整 型 附加 域 , 来 请 求 当前 的 供电 状态 。 
可 以 取 的 值 如 下 : 
STATE OFF 
STATE TURNING ON 
STATE ON 
STATE_TURNING_OFF 

Ж tf: android.bluetooth.adapter.extra.STATE. 

(15) int SCAN MODE CONNECTABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 失效 ， 但 页 面 扫描 功能 有 效 。 因 此 该 设备 不 能 被 
远程 蓝牙 设备 发 现 ， 但 如 果 以 前 曾经 发 现 过 该 设备 ， 则 远程 设备 可 以 对 其 进行 连接 。 

常量 值 : 21(0x00000015)。 

(16) int SCAN MODE CONNECTABLE DISCOVERABLE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 和 页 面 扫 描 功 能 都 有 效 。 因 此 该 设备 既 可 以 被 远 
程 蓝牙 设备 发 现 ， 也 可 以 被 其 连接 。 

常量 值 : 23(0x00000017)。 

(17) int SCAN MODE NONE 

功能 : 指明 在 本 地 蓝牙 适配器 中 ， 查 询 扫描 功能 和 页 面 扫描 功能 都 失效 。 因 此 该 设备 既 不 可 以 被 
远程 蓝牙 设备 发 现 ， 也 不 可 以 被 其 连接 。 

常量 值 : 20(0x00000014)。 

(18) int STATE OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 关闭 。 

常量 值 : 10(0x0000000a)。 

(19) int STATE ON 

功能 : 指明 本 地 蓝牙 适配器 模块 已 经 打开 ， 并 且 准 备 被 使 用 。 

(20) int STATE TURNING OFF 

功能 : 指明 本 地 蓝牙 适配器 模块 正在 关闭 。 本 地 客户 端 可 以 立刻 尝试 友好 地 断 开 任意 外 部 连接 。 

常量 值 : 13(0x0000000d)。 

(21) int STATE TURNING ON 

功能 : 指明 本 地 蓝牙 适配器 模块 正在 打开 。 然 而 本 地 客户 在 尝试 使 用 这 个 适配器 之 前 需要 为 
STATE_ON 状态 而 等 待 。 
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常量 值 : 11(0x0000000b). 
3. BluetoothAdapter 类 的 公共 方法 


(1) public boolean cancelDiscovery() 

功能 : 取消 当前 的 设备 发 现 查找 进程 ,需要 BLUETOOTH ADMIN 权限 。 因 为 对 蓝牙 适配器 而 言 ， 
查找 是 一 个 重量 级 的 过 程 ， 因 此 这 个 方法 必须 在 尝试 连接 到 远程 设备 前 使 用 connect0 方 法 进行 调用 。 
发 现 的 过 程 不 会 由 活动 来 管理 ， 但 是 它 会 作为 一 个 系统 服务 来 运行 ， 因 此 即使 它 不 能 直接 请 求 这 样 的 
一 个 查询 动作 ， 也 必须 取消 该 搜索 进程 。 如 果 蓝 牙 状态 不 是 STATE ON， 这 个 API 将 返回 falses EF 
打开 后 ， 等 待 ACTION STATE CHANGED 更 新 成 STATE ON. 

返回 值 : 成 功 则 返回 tue， 有 错误 则 返回 false。 

(2) public static boolean checkBluetoothAddress(String address) 

功能 : 验证 缘 如 “00:43:A8:23:10:F0” 之 类 的 蓝牙 地 址 ， 字 母 必 须 为 大 写 才 有 效 。 

参数 address: 字符 串 形 式 的 蓝牙 模块 地 址 。 

返回 值 : 地 址 正确 则 返回 true, BURE false. 

(3) public boolean disable() 

功能 : 关闭 本 地 蓝牙 适配器 ， 不 能 在 没有 明确 关闭 蓝牙 的 用 户 动作 中 使 用 。 这 个 方法 友好 地 停止 
所 有 的 蓝牙 连接 ， 停 止 蓝牙 系统 服务 ， 以 及 对 所 有 基础 蓝牙 硬件 进行 断 电 。 没 有 用 户 的 直接 同意 ， 蓝 
牙 永 远 不 能 被 禁止 。 这 个 disable() 方 法 只 提供 了 一 个 应 用 , 该 应 用 包含 了 一 个 改变 系统 设置 的 用 户 界面 

(例如 “电源 控制 ”应 用 )。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 , 用 户 要 通过 监听 ACTION STATE CHANGED 
值 来 获取 随后 的 适配器 状态 改变 的 通知 。 如 果 该 调用 返回 true 值 , 则 该 适配器 状态 会 立刻 从 STATE_ON 
转向 STATE TURNING _OFF， 稍 后 则 会 转 为 STATE_OFF 或 者 STATE_ON。 如 果 该 调用 返回 false, JE 
么 系统 已 经 有 一 个 保护 蓝牙 适配器 被 关闭 的 问题 ， 比 如 该 适配器 已 经 被 关闭 了 。 

需要 BLUETOOTH_ADMIN 权限 。 

返回 值 : 如 果 蓝 牙 适 配器 的 停止 进程 已 经 开启 则 返回 tue， 如 果 产 生 错 误 则 返回 false. 

(4) public boolean enable() 

功能 : 打开 本 地 蓝牙 适配器 ， 不 能 在 没有 明确 打开 蓝牙 的 用 户 动作 中 使 用 。 该 方法 将 为 基础 的 蓝 
牙 硬件 供电 ， 并 且 启 动 所 有 的 蓝牙 系统 服务 。 没 有 用 户 的 直接 同意 ， 蓝 牙 永 远 不 能 被 禁止 。 如 果 用 户 
为 了 创建 无 线 连接 而 打开 了 蓝牙 模块 , 则 其 需要 ACTION REQUEST ENABLE 值 , 该 值 将 提出 一 个 请 
求 用 户 允 许 以 打开 蓝牙 模块 的 会 话 。 这 个 enable0 值 只 提供 了 一 个 应 用 ,该 应 用 包含 了 一 个 改变 系统 设 
置 的 用 户 界 面 ( 例 如 “电源 控制 ”应 用 )。 

这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获得 返回 值 , 用 户 要 通过 监听 ACTION STATE CHANGED 
值 来 获取 随后 的 适配器 状态 改变 的 通知 .如果 该 调用 返回 true 值 , 则 该 适配器 状态 会 立刻 从 STATE_OFF 
转向 STATE_TURNING_ON， 稍 后 则 会 转 为 STATE OFF 或 者 STATE ON。 如果 该 调用 返回 false, JE 
么 说 明 系统 已 经 有 一 个 保护 蓝牙 适配器 被 打开 的 问题 ， 例 如 飞行 模式 ， 或 者 该 适配器 已 经 被 打开 。 需 
要 BLUETOOTH ADMIN 权限 。 

返回 值 : 如 果 蓝 牙 适 配器 的 打开 进程 已 经 开启 则 返回 tue， 如 果 产 生 错 误 则 返回 false。 

(5) public String getAddress() 

功能 : 返回 本 地 蓝牙 适配器 的 硬件 地 址 ， 例 如 00:11:22:AA:BB:CC. 

需要 BLUETOOTH 权限 。 
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返回 值 : 字符 串 形式 的 蓝牙 模块 地 址 。 
(6) public Set<BluetoothDevice>getBondedDevices() 
功能 : 返回 已 经 匹配 到 本 地 适配器 的 BluetoothDevice 类 的 对 象 集合 。 如 果 蓝 牙 状态 不 是 STATE 
ON， 这 个 АРІ 将 返回 false。 蓝 牙 打开 后 ， 等 待 ACTION STATE CHANGED 更 新 成 STATE_ON。 需 
要 BLUETOOTH 权限 。 
返回 值 : 未 被 修改 的 BluetoothDevice 类 的 对 象 集合 ， 如 果 有 错误 则 返回 null. 
(7) public static synchronized BluetoothAdapter getDefaultAdapter() 
功能 : 获取 对 默认 本 地 蓝牙 适配器 的 操作 权限 。 目 前 Android 只 支持 一 个 蓝牙 适配器 ， 但 是 АРІ 
可 以 被 扩展 为 支持 多 个 适配器 。 该 方法 总 是 返回 默认 的 适配器 。 
返回 值 : 返回 默认 的 本 地 适配器 ， 如 果 蓝 牙 适配器 在 该 硬件 平台 上 不 能 被 支持 ， 则 返回 null. 
(8) public String getName() 
功能 : 获取 本 地 蓝牙 适配器 的 蓝牙 名 称 , 这 个 名 称 对 于 外 界 蓝 牙 设备 而 言 是 可 见 的 。 需 要 BLUETOOTH 
权限 。 
返回 值 : 该 蓝牙 适配器 名 称 ， 如 果 有 错误 则 返回 null。 
(9) public BluetoothDevice getRemoteDevice(String address) 
功能 : 为 给 予 的 蓝牙 硬件 地 址 获取 一 个 BluetoothDevice 对 象 。 合 法 的 蓝牙 硬件 地 址 必须 为 大 写 ， 
格式 类 似 于 “00:11:22:33:AA:BB”。checkBluetoothAddress(String) 方 法 可 以 用 来 验证 蓝牙 地 址 的 正确 性 。 
BluetoothDevice 类 对 于 合法 的 硬件 地 址 总 会 产生 返回 值 ， 即 使 这 个 适配器 从 未 见 过 该 设备 。 
参数 address: 合法 的 蓝牙 MAC 地 址 。 
异常 ，IllegalArgumentException， 如 果 地 址 不 合法 。 
(10) public int getScanMode() 
ЭЁ: 获取 本 地 蓝牙 适配器 的 当前 蓝牙 扫描 模式 ， 蓝 牙 扫 描 模式 决定 本 地 适配器 可 连接 并 且 / 或 者 
可 被 远程 蓝牙 设备 所 连接 。 需 要 BLUETOOTH 权限 ， 可 能 的 取 值 如 下 : 
SCAN_MODE_NONE 
SCAN MODE CONNECTABLE 
SCAN MODE CONNECTABLE DISCOVERABLE 
如 果 蓝 牙 状 态 不 是 STATE ON， 则 这 个 АРІ 将 返回 false。 蓝 牙 打 开 后 ， 等 待 ACTION STATE - 
CHANGED 更 新 成 STATE ON. 
返回 值 : 扫描 模式 。 
(11) public int getState() 
功能 : 获取 本 地 蓝牙 适配器 的 当前 状态 ， 需 要 BLUETOOTH 类 。 可 能 的 取 值 如 下 : 
回 STATE OFF 
М STATE TURNING ON 
STATE ON 
回 STATE TURNING OFF 
返回 值 : 蓝牙 适配器 的 当前 状态 。 
(12) public boolean isDiscovering() 
功能 : 如 果 当 前 蓝牙 适配器 正 处 于 设备 发 现 查找 进程 中 ， 则 返回 真 值 。 设 备查 找 是 一 个 重量 级 过 
程 。 当 查找 正在 进行 时 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 同 时 存在 的 连接 将 获得 有 限制 
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的 带宽 以 及 高 等 待 时 间 。 用 户 可 用 cencelDiscovery0 类 来 取消 正在 执行 的 查找 进程 。 
应 用 程序 也 可 以 为 ACTION_DISCOVERY_STARTED 或 者 ACTION DISCOVERY FINISHED Ж 
行 注册 ， 从 而 当 查 找 开 始 或 者 完成 时 ， 可 以 获得 通知 。 
如 果 蓝 牙 状态 不 是 STATE ON， 这 个 АРІ 将 返回 false。 蓝 牙 打开 后 ， 等 待 ACTION_STATE_ 
CHANGED 更 新 成 STATE_ON。 需 要 BLUETOOTH 权限 。 
返回 值 : 如 果 正 在 查找 ， 则 返回 true. 
(13) public boolean isEnabled() 
功能 : 如 果 蓝 牙 正 处 于 打开 状态 并 可 用 ， 则 返回 真 值 ， 与 getBluetoothState()-—STATE ON 等 价 。 
需要 BLUETOOTH 权限 。 
返回 值 ， 如 果 本 地 适配器 已 经 打开 ， 则 返回 true. 
(14) public BluetoothServerSocket listenUsingRfcommWithServiceRecord(String name, UUID uuid) 
功能 : 创建 一 个 正在 监听 的 安全 的 带 有 服务 记录 的 无 线 射 频 通信 (RFCOMM) 蓝牙 端口 。 一 个 对 
该 端口 进行 连接 的 远程 设备 将 被 认证 ， 对 该 端口 的 通信 将 被 加 密 。 使 用 accpet0 方 法 可 以 获取 从 监听 
BluetoothServerSocket 处 新 来 的 连接 。 该 系统 分 配 一 个 未 被 使 用 的 无 线 射频 通信 通道 来 进行 监听 。 
该 系统 也 将 注册 一 个 服务 探索 协议 (SDP) 记录 ， 该 记录 带 有 一 个 包含 了 特定 的 通用 唯一 识别 码 
(Universally Unique Identifier，UUID )、 服 务 器 名 称 和 自动 分 配 通道 的 本 地 SDP 服务 。 远 程 蓝牙 设备 
可 以 用 相同 的 UUID 来 查询 自己 的 SDP 服务 器 ， 并 搜寻 连接 到 了 哪个 通道 上 。 如 果 该 端口 已 经 关闭 ， 
或 者 如 果 该 应 用 程序 异常 退出 ， 则 这 个 SDP 记录 会 被 移 除 。 使 用 createRfcommSocketToServiceRecord 
(UUID) 可 以 从 另 一 使 用 相同 UUID 的 设备 来 连接 到 这 个 端口 。 需 要 BLUETOOTH 权限 。 
参数 : 
name: SDP 记录 下 的 服务 器 名 。 
uuid: SDP 记录 下 的 UUID。 
返回 值 : 一 个 正在 监听 的 无 线 射频 通信 蓝牙 服务 端口 。 
异常 : IOException， 表 示 产 生 错误 ， 例 如 蓝牙 设备 不 可 用 ， 或 者 许可 无 效 ， 或 者 通道 被 占用 。 
(15) public boolean setName(String name) 
功能 : 设置 蓝牙 或 者 本 地 蓝牙 适配器 的 昵称 ， 这 个 名 字 对 于 外 界 蓝牙 设备 而 言 是 可 见 的 。 合 法 的 
蓝牙 名 称 最 多 拥有 248 位 UTF-8 字符 ， 但 是 很 多 外 界 设 备 只 能 显示 前 40 个 字符 ， 有 些 可 能 只 限制 前 
20 个 字符 。 
如 果 蓝牙 状态 不 是 STATE ON, 这 个 API 将 返回 falses 蓝牙 打开 后 , 等 待 ACTION STATE CHANGED 
更 新 成 STATE ON。 需要 BLUETOOTH ADMIN 权限 。 
参数 name: 一 个 合法 的 蓝牙 名 称 。 
返回 值 : 如 果 该 名 称 已 被 设 定 ， 则 返回 ttwe， 否 则 返回 false. 
(16) public boolean startDiscovery() 
功能 : 开始 对 远程 设备 进行 查找 的 进程 ， 它 通常 牵涉 到 一 个 大 概 需 时 12 秒 的 查询 扫描 过 程 ， 紧 跟 
着 是 一 个 对 每 个 获取 到 自身 蓝牙 名 称 的 新 设备 的 页 面 扫描 。 这 是 一 个 异步 调用 方法 : 该 方法 将 马上 获 
得 返回 值 ， 注 册 ACTION DISCOVERY STARTED 和 ACTION DISCOVERY FINISHED 准确 地 确定 
该 探索 是 处 于 开始 阶段 或 者 完成 阶段 。 注 册 ACTION_FOUND 以 活动 远程 蓝牙 设备 已 找到 的 通知 。 
设备 查找 是 一 个 重量 级 过 程 。 当 查找 正在 进行 时 ， 用 户 不 能 尝试 对 新 的 远程 蓝牙 设备 进行 连接 ， 
同时 存在 的 连接 将 获得 有 限制 的 带宽 以 及 高 等 待 时 间 。 用户 可 用 cencelDiscovery0 类 来 取消 正在 执行 的 
查找 进程 。 发 现 的 过 程 不 会 由 活动 来 进行 管理 ， 但 是 它 会 作为 一 个 系统 服务 来 运行 ， 因 此 即使 它 不 能 
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直接 请 求 这 样 的 一 个 查询 动作 ， 也 必须 取消 该 搜索 进程 。 设 备 搜寻 只 寻找 已 经 被 连接 的 远程 设备 。 许 
多 蓝牙 设备 默认 不 会 被 搜寻 到 ， 并 且 需 要 进入 到 一 个 特殊 的 模式 当中 。 

如 果 蓝 牙 状态 不 是 STATE ON, 这 个 API 将 返回 false. 蓝牙 打开 后 , 等 待 ACTION STATE CHANGED 
更 新 成 STATE_ON。 需 要 BLUETOOTH ADMIN 权限 。 

返回 值 : 成 功 返 回 true, HRE false. 


5.3.4 BluetoothClass.Service 类 


类 BluetoothClass.Service 的 格式 如 下 : 
public static final class BluetoothClass.Service extends Object 
类 BluetoothClass.Service 的 结构 如 下 : 
java.lang.Object 
android.bluetooth.BluetoothClass.Service 
Ж BluetoothClass.Service 用 于 定义 所 有 的 服务 类 常量 , 任意 BluetoothClass 由 0 或 多 个 服务 类 编码 
组 成 。 在 类 BluetoothClass.Service 中 包含 如 下 所 示 的 常量 : 
intAUDIO 
int CAPTURE 
int INFORMATION 
int LIMITED DISCOVERABILITY 
int NETWORKING 
int OBJECT TRANSFER 
int POSITIONING 
int RENDER 
int TELEPHONY 
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5.3.5 BluetoothClass.Device Ж 


类 BluetoothClass.Device 的 格式 如 下 : 

public final class BluetoothClass.Device extends Object 
类 BluetoothClass.Device 的 结构 如 下 : 
java.lang.Object 
android.bluetooth.BluetoothClass.Device 


类 BluetoothClass.Device 用 于 定义 所 有 的 设备 类 的 常量 ， 每 个 BluetoothClass 有 一 个 带 有 主要 和 较 
小 部 分 的 设备 类 进行 编码 。 里 面 的 常量 代表 主要 和 较 小 的 设备 类 部 分 〈 完 整 的 设备 类 ) 的 组 合 。 
BluetoothClass.Device.Major 的 常量 只 能 代表 主要 设备 类 。 
BluetoothClass.Device 有 一 个 内 部 类 , 此 内 部 类 定义 了 所 有 的 主要 设备 类 常量 。 内 部 类 的 定义 格式 如 下 : 
class BluetoothClass.Device.Major 
注意 : 至 此 ，Android 中 的 蓝牙 类 介绍 完毕 。 在 调用 这 些 类 时 ， 首 先 要 确保 API Level 至 少 为 版 本 5 以 
上 ， 并 且 还 需 添加 相应 的 权限 例如， 使 用 通信 需要 在 文件 androidmanifestxml 中 加 入 <uses- 
permission апігоій:паше="апагоій реппіѕѕіоп BLUETOOTH"/> 权 限 ， 而 在 开关 蓝牙 时 需要 加 入 
android.permission BLUETOOTH ADMIN 权限 。 
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EN 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 5 ¥\Android BlueDroid 架构 详解 .avi 
Т Т Android 系统 中 低 功 耗 蓝牙 协议 栈 BlueDroid 的 基本 知识 后 ， 本 节 将 详细 讲解 Android 源码 
中 低 功 耗 协 议 栈 BlueDroid 的 具体 架构 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


5.4.1 Android 系统 中 BlueDroid 的 架构 


在 Android 新 系统 中 ， 采 用 BlueDroid 作为 默认 的 协议 栈 ，BlueDroid 分 为 如 下 所 示 的 两 个 部 分 。 

Bluetooth Embedded System (BTE): 实现 了 BT 的 核心 功能 。 

回 Bluetooth Application Layer (BTA): 用 于 和 Android framework 层 进行 交互 。 

在 Android 新 系统 中 ，BT 系统 服务 通过 JNI 与 BT stack 进行 交互 ， 并 且 通 过 Binder IPC 通信 与 应 
交互 ， 这 个 系统 服务 同时 也 提供 给 RD 获取 不 同 的 BT profiles. [£ 5-3 展示 了 BT stack 一 个 大 体 的 结构 。 
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图 5-3 BT stack 的 结构 
5.4.2 Application Framework 层 分 析 


在 Application Framework 层 中 , 功能 是 利用 android.bluetooth APIS 和 Bluetooth Hardware 层 进行 交 
互 ， 也 就 是 通过 Binder IPC 机 制 调用 Bluetooth 进程 。Application Framework 层 的 代码 位 于 目录 
framework/base/core/java/android .bluetooth/ 中 。 
在 文件 framework/base/core/java/android/bluetooth/BluetoothA2dp.java 中 定义 了 connect(Bluetoothevice) 
方法 , 功能 是 调用 Binder IPC 通信 机 制 调用 文件 packages/apps/Bluetooth/src/com/android/bluetooth/a2dp/ 
A2dpService java 中 的 一 个 内 部 私有 类 。 


文件 BluetoothA2dp.java 的 具体 实现 代码 如 下 : 

public final class BluetoothA2dp implements BluetoothProfile { 
private static final String TAG = "BluetoothA2dp"; 
private static final boolean DBG = true; 
private static final boolean VDBG = false; 
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@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 

public static final String ACTION_CONNECTION_STATE_CHANGED = 
"android.bluetooth.a2dp.profile.action. CONNECTION. STATE CHANGED"; 

(QSdkConstant(SdkConstantType.BROADCAST. INTENT. ACTION) 

public static final String ACTION PLAYING STATE CHANGED = 
"android.bluetooth.a2dp.profile.action.PLAYING STATE CHANGED" 

public static final int STATE PLAYING = 10; 

public static final int STATE NOT PLAYING = 11; 


private Context mContext; 

private ServiceListener mServiceListener; 
private IBluetoothA2dp mService; 

private BluetoothAdapter mAdapter; 


final private IBluetoothStateChangeCallback mBluetoothStateChangeCallback = 
new IBluetoothStateChangeCallback.Stub() ( 
public void onBluetoothStateChange(boolean up) ( 
if (DBG) Log.d(TAG, "onBluetoothStateChange: up=" + up); 
if (lup) ( 
if (VDBG) Log.d(TAG,"Unbinding service..."); 
synchronized (mConnection) ( 
try( 
mService = null; 
mContext.unbindService(mConnection); 
} catch (Exception re) { 


Log.e(TAG," ге); 
} 
) else { 
synchronized (mConnection) ( 
try { 
if (mService == null) { 
if (VDBG) Log.d(TAG,"Binding service..."); 
if (ImContext.bindService(new Intent(IBluetoothA2dp.class.getName()), 
mConnection, 0)) ( 
Log.e(TAG, "Could not bind to Bluetooth A2DP Service"); 
} 
} 
} catch (Exception re) { 
Log.e(TAG,"",re); 
} 
} 
} 


} 
E 
BluetoothA2dp(Context context, ServiceListener I) { 
mContext = context; 
mServiceListener = I; 
mAdapter = BluetoothAdapter.getDefaultAdapter(); 
IBluetoothManager mgr = mAdapter.getBluetoothManager(); 
if (mgr != null) { 
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try { 
mgr.registerStateChangeCallback(mBluetoothStateChangeCallback); 
} catch (RemoteException e) { 
Log.e(TAG,"",e); 
} 
} 


if (Icontext.bindService(new Intent(IBluetoothA2dp.class.getName()), mConnection, 0)) { 
Log.e(TAG, "Could not bind to Bluetooth A2DP Service"); 
) 
} 


void close() { 
mServiceListener = null; 
IBluetoothManager mgr = mAdapter.getBluetoothManager(); 


if (mgr != null) { 
try { 
mgr.unregisterStateChangeCallback(mBluetoothStateChangeCallback); 
} catch (Exception e) { 
Log.e(TAG,"",e); 
} 
} 


synchronized (mConnection) { 
if (mService != null) { 

try { 
mService = null; 
mContext.unbindService(mConnection); 

} catch (Exception re) { 
Log.e(TAG,"",re); 

} 


} 


public void finalize() { 
close(); 
} 
public boolean connect(BluetoothDevice device) { 
if (DBG) log("connect(" + device + ")"); 
if (mService != null && isEnabled() && 
isValidDevice(device)) { 
try { 
return mService.connect(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 


return false; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return false; 


157 


Android 物 联 网 开发 从 入 门 到 实战 


} 
public boolean disconnect(BluetoothDevice device) { 
if (DBG) log("disconnect(" + device + ")"); 
if (mService != null && isEnabled() && 
isValidDevice(device)) { 
try { 
return mService.disconnect(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 


return false; 
} 

} 

if (mService == null) Log.w(TAG, "Proxy not attached to service"); 

return false; 
} 
p 
*{@inheritDoc} 
qi 


public List<BluetoothDevice> getConnectedDevices() ( 
if (VDBG) log("getConnectedDevices()"); 
if (mService != null && isEnabled()) { 
try { 
return mService.getConnectedDevices(); 
) catch (RemoteException e) ( 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return new ArrayList<BluetoothDevice>(); 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return new ArrayList<BluetoothDevice>(); 


public List<BluetoothDevice> getDevicesMatchingConnectionStates(int[] states) { 
if (VDBG) log("getDevicesMatchingStates()"); 
if (mService != null && isEnabled()) { 
try { 
return mService.getDevicesMatchingConnectionStates(states); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return new ArrayList<BluetoothDevice>(); 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return new ArrayList<BluetoothDevice>(); 
} 
public int getConnectionState(BluetoothDevice device) { 
if (VDBG) log("getState(" + device + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
try { 


return mService.getConnectionState(device); 
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} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return BluetoothProfile.STATE_DISCONNECTED; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return BluetoothProfile.STATE DISCONNECTED; 
) 
public boolean setPriority(BluetoothDevice device, int priority) ( 
if (DBG) log("setPriority(" + device + ", " + priority + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
if (priority = BluetoothProfile.PRIORITY OFF && 
priority != BluetoothProfile.PRIORITY ON)( 
return false; 
} 
try { 
return mService.setPriority(device, priority); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 


return false; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return false; 


} 
public int getPriority(BluetoothDevice device) { 
if (VDBG) log("getPriority(" + device + ")"); 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
try { 
return mService.getPriority(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return BluetoothProfile.PRIORITY OFF; 
} 
} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
return BluetoothProfile. PRIORITY_OFF; 
} 
public boolean isA2dpPlaying(BluetoothDevice device) { 
if (mService != null && isEnabled() 
&& isValidDevice(device)) { 
try { 
return mService.isA2dpPlaying(device); 
} catch (RemoteException e) { 
Log.e(TAG, "Stack:" + Log.getStackTraceString(new Throwable())); 
return false; 
) 


} 
if (mService == null) Log.w(TAG, "Proxy not attached to service"); 
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return false; 
) 
public boolean shouldSendVolumeKeys(BluetoothDevice device) { 
if (isEnabled() && isValidDevice(device)) ( 
ParcelUuid[] uuids = device.getUuids(); 
if (uuids == null) return false; 


for (ParcelUuid uuid: uuids) { 
if (BluetoothUuid.isAvrcpTarget(uuid)) { 
return true; 
} 
^ 
) 


return false; 


) 
public static String stateToString(int state) ( 
Switch (state) ( 
case STATE DISCONNECTED: 
return "disconnected"; 
case STATE CONNECTING: 
return "connecting"; 
case STATE CONNECTED: 
return "connected"; 
case STATE DISCONNECTING: 
return "disconnecting"; 
case STATE PLAYING: 
return "playing"; 
case STATE NOT PLAYING: 
return "not playing"; 
default: 
return "<unknown state " + state + ">"; 
} 
} 


private ServiceConnection mConnection = new ServiceConnection() { 
public void onServiceConnected(ComponentName className, IBinder service) { 
if (DBG) Log.d(TAG, "Proxy object connected"); 
mService = |BluetoothA2dp.Stub.asinterface(service); 


if (mServiceListener != null) { 
mServiceListener.onServiceConnected(BluetoothProfile.A2DP, BluetoothA2dp.this); 
) 
) 


public void onServiceDisconnected(ComponentName className) ( 
if (DBG) Log.d(TAG, "Proxy object disconnected"); 
mService = null; 
if (mServiceListener != null) { 
mServiceListener.onServiceDisconnected(BluetoothProfile.A2DP); 
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在 上 述 代码 中 ， 定 义 了 A2dpService 对 象 service， 并 调用 getService() 方 法 。A2dpService 是 一 个 继 
承 于 类 ProfileService 的 子 类 ， 而 ProfileService 是 继承 于 类 Service 的 子 类 。 文件 A2dpService java 的 主 
要 实现 代码 如 下 : 

public class A2dpService extends ProfileService { 


private static final boolean DBG = false; 
private static final String TAG-"A2dpService"; 


private A2dpStateMachine mStateMachine; 
private Avrcp mAvrcp; 
private static A2dpService sAd2dpService; 


protected String getName() { 
return TAG; 


} 


protected IProfileServiceBinder initBinder() { 
return new BluetoothA2dpBinder(this); 
} 


protected boolean start() { 
mStateMachine = A2dpStateMachine.make(this, this); 
mAvrcp = Avrcp.make(this); 
setA2dpService(this); 
return true; 


} 


protected boolean stop() { 
mStateMachine.doQuit(); 
mAvrep.doQuit(); 
return true; 


} 


protected boolean cleanup() { 

if (mStateMachine!= null) { 
mStateMachine.cleanup(); 

} 

if (mAvrcp != null) ( 
mAvrcp.cleanup(); 
mAvrep = null; 

} 

clearA2dpService(); 

return true; 


} 


public static synchronized A2dpService getA2dpService()( 
if (sAd2dpService != null && sAd2dpService.isAvailable()) { 
if (DBG) Log.d(TAG, "getA2DPService(): returning " + sAd2dpService); 
return sAd2dpService; 


} 
if(DBG) { 
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if (sAd2dpService == null) { 
Log.d(TAG, "getA2dpService(): service is NULL"); 
} else if (!(sAd2dpService.isAvailable())) { 
Log.d(TAG,"getA2dpService(): service is not available"); 
} 
} 
return null; 


} 


private static synchronized void setA2dpService(A2dpService instance) { 
if (instance != null && instance.isAvailable()) { 
if (DBG) Log.d(TAG, "setA2dpService(): set to: " + sAd2dpService); 
sAd2dpService = instance; 
) else ( 
if(DBG) { 
if (sAd2dpService == null) { 
Log.d(TAG, "setA2dpService(): service not available"); 
} else if (IsAd2dpService.isAvailable()) { 
Log.d(TAG,"setA2dpService(): service is cleaning up"); 
} 


} 


private static synchronized void clearA2dpService() { 
sAd2dpService = null; 
} 


public boolean connect(BluetoothDevice device) { 
enforceCallingOrSelfPermission(BLUETOOTH_ADMIN_PERM, 
"Need BLUETOOTH ADMIN permission"); 


if (getPriority(device) == BluetoothProfile. PRIORITY_OFF) { 
return false; 


} 


int connectionState = mStateMachine.getConnectionState(device); 

if (connectionState == BluetoothProfile.STATE CONNECTED || 
connectionState == BluetoothProfile.STATE CONNECTING) ( 
return false; 


) 


mStateMachine.sendMessage(A2dpStateMachine.CONNECT, device); 
return true; 


} 


boolean disconnect(BluetoothDevice device) { 
enforceCallingOrSelfPermission(BLUETOOTH_ADMIN_PERM, 
"Need BLUETOOTH ADMIN permission"); 
int connectionState = mStateMachine.getConnectionState(device); 
if (connectionState !- BluetoothProfile.SSTATE CONNECTED && 
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connectionState != BluetoothProfile.STATE CONNECTING) { 
return false; 
} 


mStateMachine.sendMessage(A2dpStateMachine.DISCONNECT, device); 
return true; 
} 
由 此 可 见 ， 在 接 下 来 的 通信 过 程 中 通过 Binder IPC 通信 机 制 调用 了 文件 A2dpService.java 中 的 
connect(BluetoothDevice) 方 法 。 上 述 过 程 就 是 Bluetooth Application Framework 与 Bluetooth Process 之 间 
的 调用 过 程 。 


543 ”分析 Bluetooth System Service E 


在 Android 系统 中 ，Bluetooth System Service 位 于 packages/apps/Bluetooth 目录 下 ， 将 其 打包 成 一 
个 “Android App( Android 应 用 程序 ) " 包 , JÉ HYE Android Framework 层 中 实现 BT Service 和 各 种 profile. 
BT App 接 下 来 会 通过 INI 调用 到 HAL 层 。 
TE X fE A2dpService java 中 ,connect0 方 法 会 发 送 一 个 StateMachine.sendMessage(A2dpStateMachine. 
CONNECT,device) 的 message (信息 0， 这 个 message 会 被 A2dpStateMachine 对 象 的 processMessage 
(Message) 方 法 接收 到 )， 对 应 代码 如 下 : 

case CONNECT: 

BluetoothDevice device = (BluetoothDevice) message.obj; 


broadcastConnectionState(device, BluetoothProfile STATE_CONNECTING, 
BluetoothProfile.STATE DISCONNECTED); 


if (IconnectA2dpNative(getByteAddress(device)) ) ( 
broadcastConnectionState(device, BluetoothProfile.STATE DISCONNECTED, 
BluetoothProfile.STATE CONNECTING); 
break; 


} 


synchronized (A2dpStateMachine.this) { 
mTargetDevice = device; 
transitionTo(mPending); 


} 
sendMessageDelayed(CONNECT_TIMEOUT, 30000); 


break; 
在 上 述 代 码 中 ， 会 通过 “connectA2dpNative(getByteAddress(device)j; ”代码 行 设置 通过 INI HA 
Native 〈 本 地 程序 ): 
private native boolean connectA2dpNative(byte[] address); 


5.44 ЈМ 层 详 解 


在 Android 系统 中 ， 和 Bluetooth 有 关 的 INI 代码 位 于 目录 packages/apps/bluetooth/jni 中 。 
INI 层 的 代码 会 调用 到 HAL 层 ， 并 且 在 确信 一 些 BT 操作 被 触发 时 从 HAL 获取 一 些 回 调 ， 例 如 当 
BT 设备 被 发 现时 .在 Адар 连接 的 例子 中 ,BT System Service 会 通过 INI 调用 文件 com_android_bluetooth_ 
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a2dp.cpp 中 的 方法 ， 此 文件 的 主要 实现 代码 如 下 : 
namespace android { 
static jmethodID method_onConnectionStateChanged; 
static jmethodID method_onAudioStateChanged; 


static const btav interface t *sBluetoothA2dplnterface = NULL; 
static jobject mCallbacksObj = NULL; 
static JNIEnv *sCallbackEnv = NULL; 


static bool checkCallbackThread() { 
ШЇ (sCallbackEnv == NULL) { 
sCallbackEnv = getCallbackEnv(); 
In 


JNIEnv* env = AndroidRuntime::getJNIEnv(); 
if (sCallbackEnv != env || sCallbackEnv == NULL) return false; 
return true; 

} 


static void bta2dp_connection_state_callback(btav_connection_state_t state, bt_bdaddr_t* bd_addr) { 
jbyteArray addr; 


ALOGI("%s", FUNCTION )j; 


if (IcheckCallbackThread()) ( Ñ 
ALOGE("Callback: '%s' is not called on the correct thread", _ FUNCTION__); X 
return; \ 

} 

addr = sCallbackEnv->NewByteArray(sizeof(bt_bdaddr_t)); 

if (laddr) ( 


ALOGE("Fail to new jbyteArray bd addr for connection state"); 
checkAndClearExceptionFromCallback(sCallbackEnv, |. FUNCTION  ); 
return; 


} 


sCallbackEnv->SetByteArrayRegion(addr, 0, sizeof(bt bdaddr t), (jbyte*) bd_addr); 
sCallbackEnv-»CallVoidMethod(mCallbacksObj, method onConnectionStateChanged, (jint) state,addr); 
checkAndClearExceptionFromCallback(sCallbackEnv, |. FUNCTION  ); 
sCallbackEnv-»DeleteLocalRef(addr); 

} 


static void bta2dp_audio_state_callback(btav_audio_state_t state, bt_bdaddr_t* bd_addr) { 
jbyteArray addr; 


ALOGI("%s", FUNCTION ); 


if (IcheckCallbackThread()) { Y 
ALOGE("Callback: '%s' is not called on the correct thread", FUNCTION );\ 
return; \ 

} 


ба 


} 


BIS Android 蓝牙 系统 详解 


addr = sCallbackEnv->NewByteArray(sizeof(bt_bdaddr_t)); 

if (laddr) { 
ALOGE("Fail to new jbyteArray bd addr for connection state"); 
checkAndClearExceptionFromCallback(sCallbackEnv, |. FUNCTION  ); 
return; 


} 


sCallbackEnv->SetByteArrayRegion(addr, 0, sizeof(bt_bdaddr_t), (jbyte*) bd_addr); 
sCallbackEnv->CallVoidMethod(mCallbacksObj, method_onAudioStateChanged, (jint) state,addr); 
checkAndClearExceptionFromCallback(sCallbackEnv, | FUNCTION ); 
sCallbackEnv->DeleteLocalRef(addr); 


static btav_callbacks_t sBluetoothA2dpCallbacks = { 


E 


sizeof(sBluetoothA2dpCallbacks), 
bta2dp connection state callback, 
bta2dp audio state callback 


static void classlnitNative(JNIEnv* env, jclass clazz) { 


) 


int err; 
const bt interface t* btinf; 
bt status t status; 


method onConnectionStateChanged = 
env->GetMethodID(clazz, "onConnectionStateChanged", "(I[B) V"); 


method onAudioStateChanged = 
env-»GetMethodlD(clazz, "onAudioStateChanged", "(I[B) V"); 
F 
if ( (btInf = getBluetoothInterface()) == NULL) { 
ALOGE("Bluetooth module is not loaded"); 
return; 


} 


if ( (sBluetoothA2dpInterface = (btav_interface_t *) 
btInf->get_profile_interface(BT_PROFILE_ADVANCED_AUDIO_ID)) == NULL) { 

ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 

} 

if ( (status = sBluetoothA2dpinterface->init(&sBluetoothA2dpCallbacks)) != BT_STATUS_SUCCESS) { 
ALOGE("Failed to initialize Bluetooth A2DP, status: %а", status); 
sBluetoothA2dpinterface = NULL; 
return; 

ү! 


ALOGI("%s: succeeds", | FUNCTION ); 


static void initNative(JNIEnv “env, jobject object) { 


const bt interface t* btInf; 
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bt_status_t status; 


if ( (btInf = getBluetoothInterface()) == NULL) { 
ALOGE("Bluetooth module is not loaded"); 
return; 


} 


if (sBluetoothA2dplInterface I-NULL) { 
ALOGW("Cleaning ир A2DP Interface before initializing..."); 
sBluetoothA2dpinterface->cleanup(); 
sBluetoothA2dpinterface = NULL; 

} 


if (mCallbacksObj != NULL) { 
ALOGW("Cleaning up A2DP callback object"); 
env-»DeleteGlobalRef(mCallbacksObj); 
mCallbacksObj = NULL; 

} 


if ( (sBluetoothA2dpInterface = (btav_interface_t *) 
btinf-»get profile interface(BT PROFILE ADVANCED AUDIO 1D)) == NULL) { 
ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 


} 


if ( (status = sBluetoothA2dpInterface->init(&sBluetoothA2dpCallbacks)) != BT STATUS SUCCESS) ( 
ALOGE("Failed to initialize Bluetooth A2DP, status: %d", status); 
sBluetoothA2dpInterface = NULL; 
return; 


} 


mCallbacksObj = env->NewGlobalRef(object); 
} 


static void cleanupNative(JNIEnv “env, jobject object) { 
const bt interface t* Ып; 
bt status t status; 


if ( (Бп? = getBluetoothInterface()) == NULL) ( 
ALOGE("Bluetooth module is not loaded"); 
return; 


} 


if (sBluetoothA2dpinterface =NULL) { 
sBluetoothA2dpinterface->cleanup(); 
sBluetoothA2dpInterface = NULL; 


} 


if (mCallbacksObj != NULL) { 


env-»DeleteGlobalRef(mCallbacksObj); 
e 


mCallbacksObj = NULL; 


} 
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static jboolean connectA2dpNative(JNIEnv “env, jobject object, jbyteArray address) { 


} 


jbyte “addr; 
bt_bdaddr_t * btAddr; 
bt_status_t status; 


ALOGI("96s: sBluetoothA2dpInterface: %p", _ FUNCTION__, sBluetoothA2dplnterface); 
if ('sBluetoothA2dpInterface) return JNI_FALSE; 


addr = env->GetByteArrayElements(address, NULL); 
btAddr = (bt_bdaddr_t *) addr; 
if (laddr) { 
jniThrowlOException(env, EINVAL); 
return JNI FALSE; 
} 


if (status = sBluetoothA2dpinterface->connect((bt_bdaddr_t *)addr)) != BT_STATUS_SUCCESS) { 
ALOGE("Failed HF connection, status: %а", status); 


env->ReleaseByteArrayElements(address, addr, 0); 
return (status == BT STATUS SUCCESS) ? JNI TRUE : JNI FALSE; 


static jboolean disconnectA2dpNative(JNIEnv *env, jobject object, jbyteArray address) ( 


) 


jbyte *addr; 
bt status t status; 


if (IsBluetoothA2dpInterface) return JNI FALSE; 


addr = env->GetByteArrayElements(address, NULL); 
if (laddr) ( 

jniThrowlOException(env, EINVAL); 

return JNI_FALSE; 
} 


if ( (status = sBluetoothA2dpInterface->disconnect((bt_bdaddr_t *)addr)) !I= BT. STATUS SUCCESS) { 
ALOGE("Failed HF disconnection, status: %d", status); 

} 

env->ReleaseByteArrayElements(address, addr, 0); 

return (status == BT. STATUS SUCCESS) ? JNI_TRUE : JNI FALSE; 


static JNINativeMethod sMethods[] = ( 


('classinitNative", "()V", (void *) classInitNative), 

(initNative", "()V", (void *) initNative}, 

('cleanupNative", "()V", (void *) cleanupNative}, 
('connectA2dpNative", "([B)Z", (void *) connectA2dpNative}, 
('disconnectA2dpNative", "([B)Z", (void *) disconnectA2dpNative}, 
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int register com android bluetooth a2dp(JNIEnv* env) 


{ 
return jniRegisterNativeMethods(env, "com/android/bluetooth/a2dp/A2dpStateMachine", 
sMethods, NELEM(sMethods)); 
} 
} 


在 上 述 代 码 中 用 到 了 结构 体 对 象 sBluetoothA2dpInterface, WX RE ATE initNative(JNIEnv*env, 
jobject objecb 中 定义 获取 ， 即 如 下 所 示 的 代码 。 
if ( (SBluetoothA2dplnterface = (btav_interface_t *) 
btinf-»get profile interface(BT PROFILE ADVANCED AUDIO ID)) == NULL) { 
ALOGE("Failed to get Bluetooth A2DP Interface"); 
return; 


} 
5.4.5 HAL iffe 


硬件 抽象 层 用 于 定义 android.bluetooth APIs 和 BT process 调用 的 标准 接口 , BT HAL 的 头 文件 位 于 
文件 hardware/libhardware/include/hardware/bluetooth.h 和 hardware/libhardware/include/hardware/bt_*.h 中 。 
JNI 中 的 sBluetoothA2dpInterface 是 一 个 btav_interface t 结构 体 ,位 于 hardware/libhardware/include/ 
hardware/bt_av.h 中 ， 具 体 定义 代码 如 下 : 
typedef struct { 
size_t size; 
bt status t (*init)( btav callbacks t* callbacks ); 
bt status t (*connect)( bt bdaddr t *bd addr ); 
bt status t (*disconnect)( bt bdaddr t *bd_adadr ); 
void (*cleanup)( void ); 
} ау interface t; 
Android 系统 新 版 本 默认 蓝牙 协议 栈 BlueDroid 在 目录 external/bluetooth/bluedroid 下 实现 。 
ЕЖ stack 实现 了 通用 的 BT HAL， 并 且 也 可 以 通过 扩展 和 改变 配置 来 自 定义 。 例 如 A2dp 的 连接 
会 调用 到 external/bluetooth/bluedroid/btif/sre/btif_av.c 的 connect0 方 法 ， 此 方法 的 具体 实现 代码 如 下 : 
static bt_status_t connect(bt_bdaddr_t *bd_addr) 


{ 

BTIF TRACE EVENT1('*6s", FUNCTION ); 

CHECK BTAV INIT(); 

return btif queue connect(UUID SERVCLASS AUDIO SOURCE, bd addr, connect int); 
) 
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从 Android 4.2 版 本 开始 ，Google 便 更 换 了 Android 的 蓝牙 协议 栈 ， 从 BlueZ 换 成 BlueDroid。 从 
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Android 4.3 版 本 开始 ， 提 供 了 对 蓝牙 4.0 BLE 的 支持 。 本 节 将 详细 讲解 Android 系统 中 的 蓝牙 4.0 BLE 
的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


5.5.1 低 功 耗 蓝牙 协议 栈 基础 


为 了 确保 Android 系统 可 以 更 好 地 支持 蓝牙 4.0 BLE, Broadcom 公司 特意 推出 了 适应 于 Android 
平台 的 开源 低 功 耗 蓝牙 协议 栈 BlueDroid， 其 开发 文档 和 АРІ 是 开源 代码 ， 在 地 址 https://github.com 
/briandbl/framework 中 保存 。 

在 上 述 开源 代码 中 ， 低 功 耗 蓝牙 API 支持 Android 平台 上 的 低 功 耗 蓝牙 通信 功能 。 通 过 使 用 
BlueDroid 协议 栈 ，Android 应 用 程序 可 以 枚 举 、 发 现 并 访问 低 功 耗 蓝牙 的 外 部 设备 ， 并 且 实 现 了 低 功 


耗 蓝牙 规范 。 
从 Android 4.2 版 本 开始 ， 低 功 耗 蓝牙 模块 的 整体 结构 如 图 5-4 所 示 。 

Settings Headset/Handsfree Opphid,a2dp 

(app/Settings) (app/Phone) (apps/Bluetooth) рас 
Bluetooth JNI m k 
android.bluetooth& (frameworks/base/core/java/android/bluetooth) иеа 
I T 1 D-BUSw 
开关 守 
Bluetooth 适 配 层 护 进 程 Bluez 
system/bluetooth/libblued external/bluetooth/hciattachlib 
roid.so bluetooth.so 
C/C++ 部 分 
RFKill I. F Hà d 
Bluez 《内 核 空间 协议 层 》 
Bluetooth ( | USB. 5010) Kemnel 部 分 


Bluetooth 芯 片 


5-4 ” 低 功 耗 蓝牙 模块 的 整体 结构 


注意 : 虽然 从 Android 42 版 本 开始 ，JNI 部 分 的 代码 在 packages 层 中 实现 。 但 是 为 了 便于 读者 从 视觉 
上 更 加 容易 接受 ， 所 以 将 ЛП 部 分 绘制 在 了 Framework 层 中 。 


5.5.2 {Е API 详解 


Broadcom 公司 推出 的 低 功 耗 蓝 牙 协 议 栈 BlueDroid 的 开发 文档 和 АРІ 是 开源 代码 ， 被 保存 在 地 址 
https://github.com/briandbl/framework 中 。 
下 面 将 详细 讲解 API 的 基本 功能 和 具体 原理 。 
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(1) 本 地 蓝牙 适配器 设备 
本 功能 不 是 由 Broadcom 公司 提供 的 , 而 是 由 Android SDK 提供 的 , 源码 位 于 目录 framework/base/ 


core/java/android.bluetooth/BluetoothA dapter.java 中 。 


文件 BluetoothAdapterjava 实现 了 所 有 蓝牙 交互 的 入 口 。 通 过 使 用 类 BluetoothAdapter 可 以 实现 如 


下 所 示 的 功能 。 
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М 发 现 其 他 的 蓝牙 设备 ， 查 询 匹 配 的 设备 集 。 
В 使 用 一 个 已 知 蓝牙 地 址 来 初始 化 蓝牙 设备 BluetoothDevice。 
回 创建 一 个 能 够 监听 其 他 设备 通信 的 类 BluetoothSocket。 
文件 BluetoothAdapterjava 的 主要 实现 代码 如 下 : 
public static synchronized BluetoothAdapter getDefaultAdapter() { 
if (sAdapter == null) { 
IBinder b = ServiceManager.getService(BLUETOOTH_MANAGER_SERVICE); 
if (b != null) { 
IBluetoothManager managerService = IBluetoothManager.Stub.aslnterface(b); 
sAdapter = new BluetoothAdapter(managerService); 
} else { 
Log.e(TAG, "Bluetooth binder is null"); 
} 
} 
return sAdapter; 


} 

p 

*Use {@link #getDefaultAdapter} to get the BluetoothAdapter instance. 
Mii 

BluetoothAdapter(IBluetoothManager managerService) { 


if (managerService == null) { 
throw new IllegalArgumentException("bluetooth manager service is null"); 
} 


try { 
mService = managerService.registerAdapter(mManagerCallback); 
} catch (RemoteException е) (Log.e(TAG, "", е);} 
mManagerService = managerService; 
mLeScanClients = new HashMap<LeScanCallback, GattCallbackWrapper>(); 
} 
public BluetoothDevice getRemoteDevice(byte[] address) { 
if (address == null || address.length != 6) { 
throw new IllegalArgumentException("Bluetooth address must have 6 bytes"); 
} 
return new BluetoothDevice(String.format("%02X:%02X:%02X:%02X:%02X:%02X", 
address[0], address[1], address[2], address[3], address[4], address[5])); 
} 
public int getState() { 
try { 
synchronized(mManagerCallback) { 
if (mService != null) 


{ 
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int state= mService.getState(); 

if (VDBG) Log.d(TAG, "" + hashCode() + ": getState(). Returning " + state); 

return state; 

} 
} 

} catch (RemoteException e) {Log.e(TAG, "", e);} 
if (DBG) Log.d(TAG, "" + hashCode() + ": getState() : mService = null. Returning STATE OFF"); 
return STATE_OFF; 


} 
public String getAddress() { 


try { 


return mManagerService.getAddress(); 
} catch (RemoteException е) (Log.e(TAG, "", е);} 
return null; 


) 
public String getName() ( 
try { 


return mManagerService.getName(); 
} catch (RemoteException e) {Log.e(TAG, "", е); 
return null; 


) 


public int getScanMode() ( 
if (getState() != STATE ON) return SCAN MODE NONE; 


try { 
synchronized(mManagerCallback) ( 
if (mService != null) return mService.getScanMode(); 


} 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return SCAN MODE NONE; 


public boolean setScanMode(int mode, int duration) ( 
if (getState() != STATE ON) return false; 


try ( 
synchronized(mManagerCallback) ( 
if (mService !- null) return mService.setScanMode(mode, duration); 


I (RemoteException e) (Log.e(TAG, "", е);} 
return false; 
} 
(2) 请 求 远程 蓝牙 设备 
本 功能 也 不 是 由 Broadcom 公司 提供 的 ,而 是 由 Android SDK 提供 的 , 源码 位 于 目录 framework/base/ 
core/java/android.bluetooth/BluetoothDevice java 中 。 
文件 BluetoothDevicejava 代表 一 个 远程 蓝牙 设备 ， 可 以 支持 BLE 低 功 耗 设备 、BR/EDR 设备 或 
Dual-mode 类 型 的 设备 。 通 过 使 用 类 BluetoothDevice 可 以 实现 如 下 所 示 的 功能 。 
М 请 求 获取 远程 蓝牙 设备 的 连接 。 
回 查询 获取 远程 蓝牙 设备 的 名 称 、 地 址 、 类 和 链接 状态 。 
文件 BluetoothDevice.java 的 主要 实现 代码 如 下 : 
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static IBluetooth getService() { 
synchronized (BluetoothDevice.class) { 
if (SService == null) { 
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter(); 
sService = adapter.getBluetoothService(mStateChangeCallback); 
} 
} 
return sService; 


} 
static IBluetoothManagerCallback mStateChangeCallback = new |BluetoothManagerCallback.Stub() { 


public void onBluetoothServiceUp(|Bluetooth bluetoothService) 
throws RemoteException { 
synchronized (BluetoothDevice.class) { 
sService = bluetoothService; 
} 
} 


public void onBluetoothServiceDown() 
throws RemoteException { 
synchronized (BluetoothDevice.class) { 


sService = null; 
} 
} 
y 
/*package*/ BluetoothDevice(String address) { 
getService(); 
if (IBluetoothAdapter.checkBluetoothAddress(address)) ( 
throw new IllegalArgumentException(address + "is not a valid Bluetooth address"); 
} 
mAddress = address; 
} 


public static final Parcelable.Creator<BluetoothDevice> CREATOR = 
new Parcelable.Creator<BluetoothDevice>() { 
public BluetoothDevice createFromParcel(Parcel in) { 
return new BluetoothDevice(in.readString()); 
} 
public BluetoothDevice[] newArray(int size) { 
return new BluetoothDevice[size]; 
) 
E 
public boolean cancelBondProcess() ( 
if (SService == null) { 
Log.e(TAG, "BT not enabled. Cannot cancel Remote Device bond"); 
return false; 
) 
try { 
return sService.cancelBondProcess(this); 
} catch (RemoteException е) {Log.e(TAG, "", е);} 
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return false; 
} 
public boolean removeBond() { 
if (sService == null) { 
Log.e(TAG, "BT not enabled. Cannot remove Remote Device bond"); 
return false; 
} 
try { 
return sService.removeBond(this); 
} catch (RemoteException e) (Log.e(TAG, "", e);} 
return false; 
} 
public int getBondState() { 
if (sService == null) { 
Log.e(TAG, "BT not enabled. Cannot get bond state"); 
return BOND_NONE; 
} 
try { 
return sService.getBondState(this); 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
catch (NullPointerException npe) { 
Log.e(TAG, "NullPointerException for getBondState() of device ("+ 
getAddress()+")", npe); 


} 
return BOND_NONE; 


} 
public BluetoothClass getBluetoothClass() { 
if (SService == null) { 
Log.e(TAG, "BT not enabled. Cannot get Bluetooth Class"); 
return null; 
} 
try { 
int classInt = sService.getRemoteClass(this); 
if (classInt == BluetoothClass.ERROR) return null; 
return new BluetoothClass(classint); 
} catch (RemoteException e) (Log.e(TAG, "", e);} 


return null; 
} 
public boolean fetchUuidsWithSdp() { 
try { 
return sService.fetchRemoteUuids(this); 
} catch (RemoteException e) (Log.e(TAG, "", е);} 
return false; 
} 


public boolean setPin(byte[] pin) { 
if (SService == null) { 
Log.e(TAG, "BT not enabled. Cannot set Remote Device pin"); 
return false; 
} 
try { 


return sService.setPin(this, true, pin.length, pin); 
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} catch (RemoteException e) (Log.e(TAG, "", e);) 


return false; 
) 
public boolean setPasskey(int passkey) ( 
r 
try { 
return sService.setPasskey(this, true, 4, passkey); 
} catch (RemoteException e) (Log.e(TAG, "", e);}*/ 
return false; 
) 


public boolean setPairingConfirmation(boolean confirm) ( 
if (Service == null) { 
Log.e(TAG, "BT not enabled. Cannot set pairing confirmation"); 
return false; 
) 
try { 
return sService.setPairingConfirmation(this, confirm); 
} catch (RemoteException e) {Log.e(TAG, "", e);} 
return false; 
} 
(3) 实现 客户 端的 低 功 耗 蓝 牙 规 范 
fE Broadcom 公司 提供 的 源码 中 ,文件 BleClientProfile.java 的 功能 是 实现 客户 端的 低 功 耗 蓝牙 规范 。 
在 应 用 中 要 想 访问 远程 设备 中 的 低 功 耗 蓝牙 规范 ， 就 必须 继承 于 类 BleClientProfile， 并 且 需 要 提供 要 
访问 规范 的 必需 参数 和 服务 标识 。 通 过 BleClientProfile 的 派生 类 可 以 发 起 一 个 远程 设备 的 连接 ， 并 且 
一 个 BleClientProfile 类 可 能 会 包含 多 个 BleClientService 对 象 的 实例 。 文 件 BleClientProfile java 的 具体 
实现 代码 如 下 : 
/下 面 是 构造 方法 ， 功 能 是 给 当前 规范 的 UUID 和 客户 端 应 用 上 下 文 创建 一 个 BleClientProfile 
public BleClientProfile(Context context, BleGattID profileUuid) 


{ 
Log.d(TAG, "new profile" + profileUuid.toString()); 
this.mContext = context; 
this. mAppUuid = profileUuid; 
this. mConnectedDevices = new ArrayList<BluetoothDevice>(); 
this. mConnectingDevices = new ArrayList<BluetoothDevice>(); 
this.mDisconnectingDevices = new ArrayList<BluetoothDevice>(); 
this.mClientIDToDeviceMap = new HashMap<iInteger, BluetoothDevice>(); 
this.mDeviceToClientIDMap = new HashMap<BluetoothDevice, Integer>(); 
this.mCallback = new BleClientCallback(); 
this.mSvcConn = new GattServiceConnection(context); 

} 

p 

* 初 始 化 BleClientProfile WR 

“tl 


public void init(ArrayList<BleClientService> requiredServices, 
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ArrayList<BleClientService> optionalServices) 


{ 
Log.d(TAG, "init (" + this. mAppUuid + ")"); 
this. mRequiredServices = requiredServices; 
this.mOptionalServices = optionalServices; 
IBinder b = ServiceManager.getService(BleConstants.BLUETOOTH LE SERVICE); 
if (b == null) ( 
throw new RuntimeException("Bluetooth Low Energy service not available"); 
} 
this. mSvcConn.onServiceConnected(null, b); 
} 
p. 
* 清 除 和 此 规范 有 关 的 资源 


sj 
public synchronized void finish() 


if (this.mSvcConn != null) ( 
this.mContext.unbindService(this.mSvcConn); 
this.mSvcConn = null; 


} 
@Override 


p 
* 返 回 此 规范 是 否 已 经 成 功 注册 到 蓝牙 协议 栈 中 
*@see {@link #registerProfile()} 

i 


public boolean isProfileRegistered() 


Log.d(TAG, "isProfileRegistered (" + this.mAppUuid + ")"); 
return this.mClientlf != BleConstants.GATT SERVICE PRIMARY; 
} 


p. 
* 注 册 规 范 到 蓝牙 协议 栈 
sl 
public int registerProfile() 
{ 
int ret = BleConstants.GATT_SUCCESS; 
Log.d(TAG, "registerProfile (" + this. mAppUuid + ")"); 


if (this. mClientlf == BleConstants.GATT_SERVICE_PRIMARY) 
{ 
try 


{ 
this.mService.registerApp(this.mAppUuid, this.mCallback); 
} catch (RemoteException e) ( 
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Log.e(TAG, e.toString()); 
ret = BleConstants.SERVICE_UNAVAILABLE; 


} 


return ret; 


} 


p 
* 注 销 蓝 牙 协议 栈 中 的 规范 

y 

public void deregisterProfile() 


Log.d(TAG, "deregisterProfile (" + this.mAppUuid + ")"); 


if (this.mClientlf != BleConstants.GATT SERVICE PRIMARY) 
try( 
this.mService.unregisterApp(this.mClientlf); 
) catch (RemoteException e) ( 
Log.e(TAG, "deregisterProfile() - " + e.toString()); 
} 
} 


p 
* 设 置 一 个 活跃 连接 设备 的 加 密 等 级 

к 

public void setEncryption(BluetoothDevice device, byte action) 


{ 
try 
{ 
this.mService.setEncryption(device.getAddress(), action); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
} 
} 
p 


“* 当 请 求 后 台 连 接 时 ， 定 义 本 地 设备 扫描 远程 低 功 耗 设备 的 强度 
public void setScanParameters(int scaninterval, int scanWindow) 


{ 
try 
{ 
this.mService.setScanParameters(scaninterval, scanWindow); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
) 
) 
p 


“建立 一 个 到 远程 设备 的 GATT 连接 
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Mi 
public int connect(BluetoothDevice device) 


{ 
Log.d(TAG, "connect (" + this. mAppUuid + ")" + device.getAddress()); 
int ret = BleConstants.GATT_SUCCESS; 
synchronized (this.mConnectingDevices) { 
this. mConnectingDevices.add(device); 
} 
synchronized (this.mDisconnectingDevices) { 
this. mDisconnectingDevices.remove(device); 
} 
try 
{ 
this.mService.open(this.mClientlf, device.getAddress(), true); 
) catch (RemoteException e) ( 
Log.e(TAG, e.toString()); 
ret - BleConstants.GATT ERROR; 
} 
return ret; 
} 
p 
* 准 备 一 个 到 远程 蓝牙 设备 的 后 台 连 接 
к! 
public int connectBackground(BluetoothDevice device) 
{ 
Log.d(TAG, 


"connectBackground (" + this. mAppUuid + ")" + device.getAddress()); 
int ret = BleConstants.GATT_SUCCESS; 


synchronized (this. mConnectingDevices) { 
this. mConnectingDevices.add(device); 


} 


synchronized (this.mDisconnectingDevices) { 
this. mDisconnectingDevices.remove(device); 
} 
try 
{ 
this.mService.open(this.mClientlf, device.getAddress(), false); 
} catch (RemoteException e) ( 


Log.e(TAG, e.toString()); 
ret = BleConstants.GATT ERROR; 


} 


return ret; 
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} 


p 
* 停 止 监听 远程 蓝牙 设备 试图 发 起 的 连接 
ie 
public int cancelBackgroundConnection(BluetoothDevice device) 
{ 
Log.d(TAG, "cancelBackgroundConnection (" + this. mAppUuid 
+") - device " + device.getAddress()); 


int ret - BleConstants.GATT SUCCESS; 
try 
{ 


this.mService.close(this.mClientlf, device.getAddress(), 0, false); 
} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
ret = BleConstants.GATT_ERROR; 
} 
return ret; 
} 
p 
* 断 开 一 个 到 远程 设备 的 GATT 连接 
public int disconnect(BluetoothDevice device) 
Log.d(TAG, 
"disconnect (" + this. mAppUuid + ") - device " + device.getAddress()); 


synchronized (this.mDisconnectingDevices) { 
this. mDisconnectingDevices.add(device); 


} 
int ret = BleConstants.GATT_SUCCESS; 


try 
{ 
this. mService.close(this.mClientif, 
device.getAddress(), 
((Integer) this. mDeviceToClientIDMap.get(device)).intValue(), 
true); 


} catch (RemoteException e) { 
Log.e(TAG, e.toString()); 
ret = BleConstants.GATT_ERROR; 
} 
return ret; 
} 
p. 
“刷新 当前 客户 端的 规范 
public int refresh(BluetoothDevice device) 
{ 
Log.d(TAG, 
"refresh (" + this.mAppUuid + ") - address = " + device.getAddress()); 
if (isDeviceDisconnecting(device)) { 
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Log.d(TAG, "refresh (" + this.mAppUuid 
+") - Device unavailable!"); 
return BleConstants.GATT ERROR; 
) 
this.mRequiredServices.get(BleConstants.GATT SERVICE PRIMARY ).refresh(device); 
return BleConstants.GATT SUCCESS; 
) 
p. 
* 刷 新 当前 规范 包含 的 特定 服务 
Mi 
public int refreshService(BluetoothDevice device, BleClientService service) 
{ 
Log.d(TAG, "refreshService (" + this. mAppUuid + ") address = s " 
+ device.getAddress() + "service = " + service.getServiceld()); 
return 0; 
} 
p. 
* 在 已 经 连接 的 设备 列表 中 查找 指定 蓝牙 设备 的 地 址 
Y 
public BluetoothDevice findConnectedDevice(String address) 


BluetoothDevice ret = null; 
synchronized (this.mConnectedDevices) { 
for (int i = 0; i != this.mConnectedDevices.size(); i++) { 
BluetoothDevice d = (BluetoothDevice) this.mConnectedDevices.get(i); 
if (address.equalsignoreCase(d.getAddress())) ( 


ret = d; 
break; 
} 
} 
} 
return ret; 
} 
p. 
* 返 回 当前 连接 和 等 待 连接 中 的 所 有 远程 设备 集合 
ү! 
public BluetoothDevice[] getPendingConnections() 
( 
return (BluetoothDevice[]) this.mConnectingDevices.toArray(new BluetoothDevice[0]); 
} 
p. 


“设置 一 个 蓝牙 设备 地 址 ， 在 等 待 连接 设备 列表 中 查找 一 个 远程 设备 
public BluetoothDevice findDeviceWaitingForConnection(String address) 
{ 
BluetoothDevice ret = null; 
synchronized (this.mConnectingDevices) { 
for (int i = 0; i < this.mConnectingDevices.size(); i++) ( 
BluetoothDevice d = (BluetoothDevice) this.mConnectingDevices.get(i); 
if (address.equalslgnoreCase(d.getAddress())) { 
ret- d; 
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break; 
] 
) 

} 

return ret; 
} 
void onServiceRefreshed(BleClientService s, BluetoothDevice device) 
{ 


int i = this. mRequiredServices.indexOf(s); 
if (i+ 1 < this. mRequiredServices.size()) { 
Log.d(TAG, "Refreshing next service"); 
((BleClientService) this. mRequiredServices.get(i + 1)).refresh(device); 


) else { 
onRefreshed(device); 
) 
public void onlnitialized(boolean success) 
{ 
Log.d(TAG, "onlnitialized"); 
if (success) 
registerProfile(); 
} 


public void onServiceConnected(ComponentName name, IBinder service) 
Log.d(TAG, "Connected to GattService!"); 


if (service != null) 


try { 
BleClientProfile.this.mService = IBluetoothGatt.Stub.asInterface(service); 


for (int i = 0; i < BleClientProfile.this.mRequiredServices.size(); i++) ( 
BleClientProfile.this.mRequiredServices.get(i) 
-setProfile(BleClientProfile.this ); 
} 


if (BleClientProfile.this.mOptionalServices != null) { 
for (int i = 0; i < BleClientProfile.this. mOptionalServices.size(); i++) { 
BleClientProfile.this.mOptionalServices 
.get(i).setProfile(BleClientProfile.this ); 


} 


BleClientProfile.this.onlnitialized(true); 

} catch (Throwable t) { 
Log.e(TAG, "Unable to get Binder to GattService", t); 
BleClientProfile.this.onlnitialized(false); 

) 

} 
(4) 创建 一 个 代表 客户 端 角色 设备 上 的 低 功 耗 蓝牙 服务 派生 类 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleClientService java 的 功能 是 定义 一 个 派生 类 ， 此 派 和 4 


出 
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代表 了 客户 端 角 色 设备 上 的 低 功 耗 蓝牙 服务 。 通 过 这 个 派生 类 可 以 允许 应 用 程序 读 写 低 功 耗 蓝 牙 服务 
的 特征 ， 并 在 特征 改变 时 注册 通知 。 文 件 BleClientService.java 的 主要 实现 代码 如 下 : 

// 定 义 代表 客户 端的 低 功 耗 服务 

public abstract class BleClientService 


{ 


private static String TAG = "BleClientService"; 


private BleClientProfile mProfile = null; 

private BleGattID mServiceld = null; 

private HashMap<BluetoothDevice, ArrayList<ServiceData>> mdeviceToDataMap = 
new HashMap<BluetoothDevice, ArrayList<ServiceData>>(); 

private BleCharacteristicDataCallback mCallback = 
new BleCharacteristicDataCallback(); 

private boolean mReadDescriptors = true; 


p 
“创建 一 个 新 的 低 功 耗 蓝 牙 服务 的 ОШО 


*@param serviceld 

zi 

public BleClientService(BleGattID serviceld) 
{ 


mServiceld = serviceld; 
if (mServiceld.getServiceType() == BleConstants.GATT_UNDEFINED) 
mServiceld.setServiceType(BleConstants.GATT SERVICE PRIMARY); 
} 


p 
* 返 回 服务 的 UUID 

Ei 

public BleGattID getServiceld() 
{ 


} 


return mServiceld; 


p. 
* 写 操作 远程 设备 上 的 一 个 特性 
zi 
public int writeCharacteristic(BluetoothDevice remoteDevice, int instanceld, 
BleCharacteristic characteristic) 
{ 
Log.d(TAG, "writeCharacteristic"); 


int ret - BleConstants.GATT SUCCESS; 
int connID = BleConstants.GATT INVALID CONN ID; 


if ((connID = mProfile.getConnidForDevice(remoteDevice)) == BleConstants.GATT INVALID CONN ID) { 
return BleConstants.GATT INVALID CONN ID; 
5 


ServiceData s 7 getServiceData(remoteDevice, instanceld); 
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if (s == null) { 
return ret; 


} 


S.writelndex = s.characteristics.indexOf(characteristic); 


if ((s.characteristics != null) && (s.writelndex >= BleConstants.GATT_SERVICE_PRIMARY)) { 
Log.d(TAG, "writeCharacteristic found characteristic in array:"); 
Log.d(TAG, 
"Service = [instancelD = " + instanceld + " svcid = " 
+ mServiceld.toString() + " serviceType = " 
+ mServiceld.getServiceType()); 
Log.d(TAG, "CharlD = [instancelD = " + characteristic.getInstancelD() 
+" svcid =" + characteristic.getID().toString()); 
BleGattlD svcld = new BleGattlD(instanceld, mServiceld.getUuid(), 
mServiceld.getServiceType()); 
BleGattlD cID = characteristic.getlD(); 
BluetoothGattCharlD charlD = new BluetoothGattCharlD(svcld, cID); 


try 


if (characteristic.isDirty()) { 
if (characteristic.getWriteType() == BleConstants.GATT SUCCESS) 
characteristic.setWrite Type(2); 
characteristic.setDirty(false); 
mProfile.getGattService().writeCharValue(connID, charlD, 
characteristic.getWrite Type(), characteristic.getAuthReq(), 
characteristic.getValue()); 


} 
else if (Icharacteristic.getDirtyDescQueue().isEmpty()) { 
ArrayList<BleDescriptor> descList = 
characteristic.getDirtyDescQueue(); 
BleDescriptor descObj = descList.get(0); 


Log.d(TAG, "writeCharacteristic - descriptor = " 
+ descObj.getID().toString()); 
if (descObj.isDirty()) { 
BluetoothGattCharDescrID descID = new BluetoothGattCharDescrID( 
svcld, clD, descObj.getlD()); 
descObj.setDirty(false); 
mProfile.getGattService().writeCharDescrValue(connID, 
desclD, descObj.getWriteType(), descObj.getAuthReq(), 
descObj.getValue()); 


onWriteCharacteristicComplete(0, remoteDevice, characteristic); 


} 
} catch (RemoteException e) { 
ret = BleConstants.GATT_ERROR; 
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} 
) else { 

onWriteCharacteristicComplete(0, remoteDevice, characteristic); 
} 


return ret; 


} 


p 
* 检 索 服务 包含 的 所 有 特征 

4i 

public ArrayList<BleCharacteristic> getAllCharacteristics(BluetoothDevice remoteDevice) 


{ 
Log.d(TAG, "getAllCharacteristics"); 


ServiceData s = getServiceData(remoteDevice, mServiceld.getInstancelD()); 
if (null != s) ( 
return s.characteristics; 


return null; 


} 


p 
* 返 回 一 个 基于 它 的 ID 的 服务 特性 
public BleCharacteristic getCharacteristic(BluetoothDevice remoteDevice, 
BleGattID characteristicID) 
{ 
Log.d(TAG, "getCharacteristic charlD = [" + characteristicID.toString() 
+ "] instance ID = [" + characteristicID.getInstancelD() + "]"); 
ServiceData s = getServiceData(remoteDevice, mServiceld.getInstancelD()); 


if (s == null) ( 
Log.d(TAG, "getCharacterisic - Service data not found"); 
return null; 

} 


for (int i = 0; i < s.characteristics.size(); i++) { 
BleCharacteristic c = s.characteristics.get(i); 
if (c != null) { 
if (c.getID() != null) ( 
if ((c.getID().toString().equals(characteristicID.toString())) 
&& (c.getinstancelD() == characteristicID.getInstancelD())) 


{ 
return c; 
} 
} 
else 
Log.d(TAG, "Error: Characteristic ID is null"); 
} 
else { 
Log.d(TAG, "Error: Cannot retrieve characteristic"); 
} 
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return null; 


} 


n 
* 返 回 所 有 服务 实例 的 IDs 列表 
public int getAllServicelnstancelds(BluetoothDevice remoteDevice) 


{ 
Log.d(TAG, "getAllServicelnstancelds"); 
ArrayList<ServiceData> s = mdeviceToDataMap.get(remoteDevice); 
if (s != null) ( 
int[] instancelds = new int[s.size()]; 
for (inti = 0; i < s.size(); i++) ( 
instancelds[i] = s.get(0).instancelD; 
} 
return instancelds; 
} 
return null; 
} 
p 
“刷新 远程 服务 的 所 有 实例 的 所 有 特性 
‘fl 
public void refresh(BluetoothDevice remoteDevice) 
{ 
Log.d(TAG, "Refresh (" + mServiceld.toString() + ")"); 
ArrayList<ServiceData> s = mdeviceToDataMap.get(remoteDevice); 
if (s != null) { 
ServiceData sd = s.get(0); 
Log.e(TAG, 
"refresh() - Service data found, reading first characteristic... (serviceType = " 
+ sd.serviceType + ")"); 
readFirstCharacteristic(remoteDevice, new BleGattID(sd.instancelD, 
getServiceld().getUuid(), sd.serviceType)); 
} else { 
Log.e(TAG, "refresh() - Service data not found"); 
} 
} 
p 
* 从 远程 设备 上 读 取 指 定 的 特性 


*@see {@link #onReadCharacteristicComplete(BluetoothDevice,BleCharacteristic)} 
ui 
public int readCharacteristic(BluetoothDevice remoteDevice, 

BleCharacteristic characteristic) 
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int ret = BleConstants.GATT_SUCCESS; 
int connID = BleConstants.GATT_INVALID_CONN_ID; 
Log.d(TAG, 
"readCharacteristic - svc UUID =" + getServiceld().getUuid().toString() 
+", characteristic = " + characteristic.getID()); 


BluetoothGattCharlD charlD = new BluetoothGattCharlD(new BleGattlD( 
characteristic.getInstancelD(), getServiceld().getUuid(), getServiceld() 
.getServiceType()), characteristic.getID()); 


if ((connID = mProfile.getConnidForDevice(remoteDevice)) {= BleConstants.GATT INVALID CONN 10) 
readCharacteristicValue(connID, charlD, characteristic.getAuthReq()); 

else ( 
ret - BleConstants.GATT INVALID CONN ID; 

} 

return ret; 


} 


p 

* 设 置 一 个 远程 设备 特性 的 写 操作 已 经 完成 的 函数 

di 

public void onWriteCharacteristicComplete(int status, BluetoothDevice remoteDevice, 
BleCharacteristic characteristic) 


Log.d(TAG, "onWriteCharacteristicComplete 1 status-" + status); 
if (status == BleConstants.GATT_INSUF_AUTHENTICATION) { 
Log.d(TAG, 
"onWriteCharacteristicComplete rev GATT_INSUF_AUTHENTICATION issue createBond"); 
if (remoteDevice.createBond()) 
Log.d(TAG, "onWriteCharacteristicComplete createBond request Accepted"); 
else ( 
Log.e(TAG, "onWriteCharacteristicComplete createBond request FAILED"); 


} 
} 
else if (status == BleConstants.GATT_INSUF_ENCRYPTION) { 
Log.d(TAG, 
"onWriteCharacteristicComplete rev GATT_INSUF_ENCRYPTION check link can be encrypt 
or not"); 
if (remoteDevice.getBondState() == BluetoothDevice.BOND_BONDED) { 
Log.d(TAG, 
"device bonded start to encrypt the link. !!!! This case should not happen !!!!"); 
else { 
Log.d(TAG, "device is Not bonded start to pair"); 
remoteDevice.createBond(); 
} 
} 
} 
p 


“设置 一 个 远程 特性 已 经 改变 的 回调 函数 
4 
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public void onCharacteristicChanged(BluetoothDevice remoteDevice, 
BleCharacteristic characteristic) 


{ 


p 
* 设 置 服务 已 经 完成 一 次 刷新 的 回调 函数 

sii 

public void onRefreshComplete(BluetoothDevice remoteDevice) 


{ 
} 


p 

* 当 蓝牙 服务 需要 连接 认证 时 触发 的 回调 函数 

sii 

public void onSetCharacteristicAuthRequirement(BluetoothDevice remoteDevice, 
BleCharacteristic characteristic, int instancelD) 


Log.d(TAG, "onCharacteristicChanged"); 


Log.d(TAG, "onRefreshComplete"); 


Log.d(TAG, "onSetCharacteristicAuthRequirement"); 
} 


p 

* 当 一 个 设置 的 特性 被 更 新 ， 并 且 读 取 其 值 和 描述 符 时 会 被 调用 

i 

public void onReadCharacteristicComplete(BluetoothDevice remoteDevice, 
BleCharacteristic characteristic) 


Log.d(TAG, "onReadCharacteristicComplete"); 
} 


public void onReadCharacteristicComplete(int status, BluetoothDevice remoteDevice, 
BleCharacteristic characteristic) 
{ 
Log.d(TAG, "onReadCharacteristicComplete status=" + status); 
if (status == BleConstants.GATT_INSUF_AUTHENTICATION) { 
Log.d(TAG, 
"onReadCharacteristicComplete rev GATT_INSUF_AUTHENTICATION issue createBond"); 
remoteDevice.createBond(); 
return; 
} 
if (status != BleConstants.GATT_INSUF_ENCRYPTION) { 
return; 


} 


Log.d(TAG, 
"onReadCharacteristiccomplete rev GATT_INSUF_ENCRYPTION check link can be encrypt 


or not"); 


if (remoteDevice.getBondState() == BluetoothDevice.BOND BONDED) { 
Log.d(TAG,"device bonded start to encrypt the link. !!!! This case should not happen ! 


BSS Android 蓝牙 系统 详解 


) else { 
Log.d(TAG, "device is Not bonded start to pair"); 
remoteDevice.createBond(); 


} 
p. 
* 注 册 此 服务 在 服务 器 上 的 通知 
Mi 
public int registerForNotification(BluetoothDevice remoteDevice, int instancelD,BleGattID characteristicID) 
{ 
int ret = BleConstants.GATT_SUCCESS; 
Log.d(TAG, "registerForNotification address: " + remoteDevice.getAddress()); 
try { 
BleGattID svcld = new BleGattID(instancelD, getServiceld().getUuid(), 
getServiceld().getServiceType()); 
BluetoothGattCharlD charld = new BluetoothGattCharlD(svcld, characteristicID); 
mProfile.getGattService().registerForNotifications( 
mProfile.getClientlf(), remoteDevice.getAddress(), charld); 
} catch (RemoteException e) ( 
ret = BleConstants.GATT ERROR; 
} 
return ret; 
} 
p 
* 取 消 从 服务 器 的 通知 服务 
M 
public int unregisterNotification(BluetoothDevice remoteDevice, int instancelD,BleGattlD characteristicID) 
{ 
int ret = BleConstants.GATT_SUCCESS; 
Log.d(TAG, "unregisterNotification address: " + remoteDevice.getAddress()); 
try { 
BleGattlD svcld = new BleGattID(instancelD, getServiceld().getUuid(), 
getServiceld().getServiceType()); 
BluetoothGattCharlD charld = new BluetoothGattCharlD(svcld, characteristiclD); 


mProfile.getGattService().deregisterForNotifications( 
mProfile.getClientlf(), remoteDevice.getAddress(), charld); 
) catch (RemoteException e) ( 
ret = BleConstants.GATT ERROR; 


} 

return ret; 
} 
void setInstancelD(BluetoothDevice remoteDevice, int instanceld) 
{ 


Log.d(TAG, "setinstancelD address = " + remoteDevice.getAddress()); 
ServiceData sd = getServiceData(remoteDevice, instanceld); 
mServiceld.setinstanceld(instanceld); 
if (null == sd) { 
Log.d(TAG, "setinstancelD setting instance id (" + instanceld + ")"); 
sd = new ServiceData(); 
sd.instancelD = mServiceld.getinstancelD(); 
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} 


sd.serviceType = mServiceld.getServiceType(); 
ArrayList<ServiceData> s = mdeviceToDataMap.get(remoteDevice); 
if (null == s) ( 

s = new ArrayList<ServiceData>(); 
) 
s.add(sd); 
mdeviceToDataMap.put(remoteDevice, s); 


sd.instancelD = mServiceld.getinstancelD(); 
sd.serviceType = mServiceld.getServiceType(); 


try 
{ 


CONN ID) 


int connID = BleConstants.GATT INVALID CONN ID; 
if ((connID = mProfile.getConnldForDevice(remoteDevice)) != BleConstants.GATT INVALID - 


mProfile.getGattService().registerServiceDataCallback(connID, 
mServiceld, remoteDevice.getAddress(), mCallback); 


} catch (RemoteException e) 


} 


Log.d(TAG, e.toString()); 


} 
// 获 得 第 一 个 特征 描述 符 
public void onGetFirstCharacteristicDescriptor(int connID, int status, 


BluetoothGattID svcld, BluetoothGattID characteristicID, 
BluetoothGattID descriptorlD) 


Log.d(BleClientService.TAG, "onGetFirstCharacteristicDescriptor " 
+ characteristicID.toString() + " status =" + status); 


BluetoothDevice device = BleClientService.this.mProfile.getDeviceforConnld(connID); 
if ((device == null) 
|| (BleClientService.this.mProfile.isDeviceDisconnecting(device))) { 
Log.e(BleClientService.TAG, 
“onGetFirstCharacteristicDescriptor() - Device is disconnecting..."); 
return; 


} 


if (status != BleConstants.GATT_SUCCESS) { 
BleClientService.this.readNextCharacteristic( 
BleClientService.this.mProfile.getDeviceforConnld(connID), 
BleApiHelper.gatt2BlelD(svcld), 
BleApiHelper.gatt2BlelD(characteristicID)); 
return; 


} 
Log.d(BleClientService.TAG, 
"characteristic ID = " + characteristicID.toString() + "instance ID =" 
+ characteristicID.getInstancelD()); 


BleCharacteristic characteristic = findCharacteristic(connID, 
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BleApiHelper.gatt2BlelD(svcld), BleApiHelper.gatt2BlelD(characteristicID)); 


if (descriptorID.getUuidType() == BleConstants.GATT UUID TYPE 128)( 
String uuid128 = descriptorID.getUuid().toString(); 
if (uuid128.equals("00002900-0000-1000-8000-00805f9b34fb")) 
characteristic.addDescriptor(new BleExtProperty()); 
else if (uuid128.equals("00002902-0000-1000-8000-00805f9b34fb")) 
characteristic.addDescriptor(new BleClientConfig()); 
else if (uuid128.equals("00002903-0000-1000-8000-00805f9b34fb")) 
characteristic.addDescriptor(new BleServerConfig()); 
else if (uuid128.equals("00002904-0000-1000-8000-00805f9b34fb")) 
characteristic.addDescriptor(new BlePresentationFormat()); 
else if (uuid128.equals("00002901-0000-1000-8000-00805f9b34fb")) 
characteristic.addDescriptor(new BleUserDescription()); 
else 
characteristic.addDescriptor(new BleDescriptor(new BleGattlD( 
descriptorID.getUuid()))); 
} 
else { 
switch (descriptorID.getUuid16()) { 
case BleConstants.GATT_UUID_CHAR_EXT_PROP16: 
characteristic.addDescriptor(new BleExtProperty()); 
break; 
case BleConstants.GATT_UUID_CHAR_CLIENT_CONFIG16: 
characteristic.addDescriptor(new BleClientConfig()); 
break; 
case BleConstants.GATT UUID CHAR SRVR CONFIG16: 
characteristic.addDescriptor(new BleServerConfig()); 
break; 
case BleConstants.GATT UUID CHAR PRESENT FORMAT 16: 
characteristic.addDescriptor(new BlePresentationFormat()); 
break; 
case BleConstants.GATT UUID CHAR DESCRIPTION16: 
characteristic.addDescriptor(new BleUserDescription()); 
break; 
default: 
characteristic.addDescriptor(new BleDescriptor(new BleGattlD( 
descriptorID.getUuid16()))); 


} 


BleClientService.this.readNextCharDescriptor( 
BleClientService.this.mProfile.getDeviceforConnld(connID), 
BleApiHelper.gatt2BlelD(svcld), BleApiHelper.gatt2BlelD(characteristicID), 
BleApiHelper.gatt2BlelD(descriptorlD)); 


} 
C5) 定义 服务 器 端的 角色 的 低 功 耗 规范 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleServerProfilejava 的 功能 是 定义 了 服务 器 端的 角色 的 低 
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功 耗 规范 ， 在 创建 一 个 新 的 低 功 耗 规范 之 前 ， 需 要 先 继承 于 这 个 类 ， 并 提供 标识 要 访问 规范 所 必需 的 
参数 和 服务 。 通 常 来 说 ， 一 个 BleServerProfile 派生 的 类 包含 一 个 或 多 个 BleServerService 对 象 。 在 
BleServerProfile 派生 的 类 中 ， 包 含 低 功 耗 规范 中 定义 服务 的 BleServerService 对 象 的 集合 。 文 件 


BleServerProfile.java 的 主要 实现 代码 如 下 : 

public abstract class BleServerProfile 

{ 
private static final boolean D = true; 
private static final String TAG = "BleServerProfile"; 
private Context mCtxt = null; 
private BleGattlD mAppid; 
ArrayList«BleServerService» mServiceArr - null; 
private HashMap<String, Integer» mConnMap = null; 
private HashMap<integer, Integer» mMtuMap = null; 
private IBluetoothGatt mService; 
private int mSvcCreated = 0; 
private int mSvcStarted = 0; 
private byte mAppHandle 7 -1; 
private int mProfileStatus = 2; 
private GattServiceConnection mSvcConn; 


public BleServerProfile(Context ctxt, BleGattID appld,ArrayList«BleServerService» serviceArr) 
{ 

mAppid = appld; 

mCtxt = ctxt; 

mServiceArr = serviceArr; 

mConnMap = new HashMap<String, Integer>(); 

mMtuMap = new HashMap<integer, Integer>(); 

mSvcConn = new GattServiceConnection(null); 

Intent i = new Intent(); 

i.setClassName("com.broadcom.bt.app.system", "com.broadcom.bt.app.system.GattService"); 

mCtxt.bindService(i, mSvcConn, 1); 


throw new RuntimeException("Not implemented"); 


} 

取消 和 此 规范 相关 的 资源 */ 
public synchronized void finish() 
{ 


if (mSvcConn != null) ( 
mCtxt.unbindService(mSvcConn); 
mSvcConn = null; 


} 


public void finalize() 


{ 
finish(); 


} 
/初始 化 相关 的 服务 ”/ 
void initProfile() 


{ 


®© 
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Log.i("BleServerProfile", "initProfile()"); 


try { 
mService.registerServerProfileCallback(mAppid, new BleServerProfileCallback(this)); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to start profile", t); 
) 
) 
void notifyAction(int event) 
{ 


if ((event == 0) && (++mSvcCreated == mServiceArr.size())) 


Log.i("BleServerProfile", 
"All services created successfully. Calling onlnitialized"); 
onlnitialized(true); 
} else if ((event == 4) && (-mSvcCreated == 0)) 


Log.i("BleServerProfile", 
"All services stopped successfully. Calling onStopped"); 
onStopped(); 
} else if ((event == 2) && (++mSvcStarted == mServiceArr.size())) 


Log.i("BleServerProfile", 
"All services started successfully. Calling onStarted"); 
onStarted(true); 
} else if (event == 1) ( 
Log.i("BleServerProfile", 
"One of the services creation failed. Calling onlnitialized"); 
mProfileStatus = 2; 
oninitialized(false); 
} else if (event == 3) { 
Log.i("BleServerProfile", 
"One of the services start failed. Calling onStarted"); 
mProfileStatus = 2; 
onStarted(false); 
} else ( 
Log.e("BleServerProfile", "Unknown action from a service"); 


} 


} 
启用 和 此 规范 有 关 的 所 有 服务 */ 
public void startProfile() 


{ 
Log.i("BleServerProfile", "startProfile()"); 


if (mService == null) { 
Log.i("BleServerProfile", "Remote service object is null.. Returning.."); 
return; 


} 


for (int i = 0; i < mServiceArr.size(); i++) ( 
if (((BleServerService) mServiceArr.get(i)).isRegistered()) { 
Log.i("BleServerProfile", 
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"One of the services is not registered. Stopping all the services"); 
stopProfile(); 
return; 


} 


((BleServerService) mServiceArr.get(i)).startService(); 


} 


} 
”停止 和 此 规范 有 关 的 所 有 服务 */ 
public void stopProfile() 
{ 
Log.i("BleServerProfile", "stopProfile()"); 
for (int i = 0; i « mServiceArr.size(); i++) 
((BleServerService) mServiceArr.get(i)).stopService(); 


} 
A* 注 销 所 有 相关 的 服务 */ 
public void finishProfile() 


Log.i("BleServerProfile", "finishProfile()"); 
for (int i = 0; i < mServiceArr.size(); i++) { 
((BleServerService) mServiceArr.get(i)).deleteService(); 


} 
try 
{ 
mService.unregisterServerProfileCallback(mAppHandle); 
} catch (Throwable t) { 


Log.e("BleServerProfile", "Unable to stop profile", t); 
return; 


} 


} 
/为 连接 设置 最 大 传输 单元 %/ 
public void setMtuSize(int connld, int mtuSize) 


Log.i("BleServerProfile", "setMtuSize"); 
mMtuMap.put(Integer.valueOf(connld), Integer.valueOf(mtuSize)); 


} 
/为 一 个 活跃 的 连接 设置 需要 的 加 密 等 级 */ 
public void setEncryption(String bdaddr, byte action) 
{ 
try 
mService.setEncryption(bdaddr, action); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to set encryption for connection", t); 


} 


} 
/* 当 已 经 请 求 一 个 后 台 连 接 时 ， 定 义 本 地 设备 扫描 远程 低 功 耗 设备 的 强度 */ 
public void setScanParameters(int scaninterval, int scanWindow) 
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mService.setScanParameters(scaninterval, scanWindow); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to set scan parameters", t); 


} 


} 
/打开 一 个 外 设 САР 客户 端的 连接 */ 
public void open(String bdaddr, boolean isDirect) 
{ 
try 


{ 
mService.GATTServer Open(mAppHandle, bdaddr, isDirect); 


} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Gatt connection", t); 


} 


} 
/取消 一 个 正在 进行 中 对 外 设 GATT 客户 端的 打开 操作 */ 
public void cancelOpen(String bdaddr, boolean isDirect) 
{ 
try 


{ 
mService.GATTServer_CancelOpen(mAppHandle, bdaddr, isDirect); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Gatt connection", t); 
return; 


} 


} 
/* 关 闭 一 个 到 远程 低 功 耗 规范 客户 端的 连接 */ 
public void close(String bdaddr) 
{ 
try 


{ 
mService.GATTServer_Close(((Integer) mConnMap.get(bdaddr)) 


intValue()); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to open Сай connection", t); 
return; 


) 


) 
I'24—^ 3 Prim Уг АТЕНЕ 5 Re ER C 
public void onClientConnected(int connld, String bdaddr, boolean isConnected) 


{ 
Log.i("BleServerProfile", "onClientConncted addr is " + bdaddr + " connld is " + connld); 
mProfile.onClientConnected(bdaddr, isConnected); 
if (isConnected) 
mProfile.mConnMap.put(bdaddr, Integer.valueOf(connld)); 
else 
mProfile.mConnMap.remove(bdaddr); 
} 


private class GattServiceConnection 
implements ServiceConnection 
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{ 
private Context context; 
private GattServiceConnection(Context c) { 
context = c; 
} 
public void onServiceConnected(ComponentName name, IBinder service) 
{ 
Log.d("BleServerProfile", "Connected to GattService!"); 
if (service != null) 
try { 
BleServerProfile.this. mService = IBluetoothGatt.Stub.asInterface(service); 
BleServerProfile.this.initProfile(); 
} catch (Throwable t) { 
Log.e("BleServerProfile", "Unable to get Binder to GattService", t); 
} 
} 
public void onServiceDisconnected(ComponentName name) 
Log.d("BleServerProfile", "Disconnected from GattService!"); 
} 
} 


} 
(6) 创建 低 功 耗 服务 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleServerService.java 的 功能 是 创建 一 个 低 功 耗 服 务 ， 这 是 
服务 器 端 角 色 上 的 低 功 耗 规范 的 一 部 分 。BleServerService 的 派生 类 包含 了 一 个 或 多 个 BleCharacteristic 
对 象 。 在 应 用 程序 中 ， 需 要 重 写 类 BleServerService 来 实现 一 个 服务 。 文 件 BleServerService.java 的 主 
要 实现 代码 如 下 : 
public abstract class BleServerService 


{ 


private final String TAG = "BleServerService"; 


private HashMap«lInteger, BleCharacteristic> mCharHdlMap = null; 
private HashMap«lInteger, BleServerService> mServiceHdlMap = null; 
private HashMap«lInteger, AttributeRequestInfo» mAttrReqMap = null; 


private ArrayList<BleCharacteristic> mCharQueue = null; 
private ArrayList<BleDescriptor> mDirtyDescQueue = null; 
private BleGattlD mServiceld; 

private BleGattlD mAppUuid; 

private BleServerProfile mProfileHandle; 

private IBluetoothGatt mService; 

private int mSvcHandle - -1; 

private byte mSupTransport; 

private BleServiceCallback mGattServiceCallback; 

private boolean isServiceAvailable - false; 
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private int mSvclnstance = 0; 


private boolean isPrimary = false; 

private int mNumHandles; 

private final int CHAR_ADDED = 0; 

private final int CHAR_DESC_ADDED = 1; 
private final int ATTRIBUTE_WRITE = 2; 
private final int ATTRIBUTE_READ = 3; 
private final int HDL_VAL_INDICATION = 4; 
private final int HDL_VAL_NOTIFICATION = 5; 
private final int MTU EXCHANGE = 6; 

private final int EXECUTE_WRITE = 7; 


private Handler mHandler = new Handler() 

{ 
public void handleMessage(Message msg) 
{ 
} 


} 
/构造 函数 ， 使 用 给 定 的 ID 构造 一 个 低 功 耗 服务 */ 
public BleServerService(BleGattID serviceld, int numHandles) 
{ 
p 
* TODO: implement 
ul 
this.mServiceld = serviceld; 
this. mNumHandles = numHandles; 
this. mSupTransport = 2; 
this.mGattServiceCallback = new BleServiceCallback(this); 
this. mCharHdIMap = new HashMap(); 
this.mServiceHdlMap = new HashMap(); 
this. mCharQueue = new ArrayList(); 
this. mAttrReqMap = new HashMap(); 


if (this. mServiceld.getServiceType() == -1) 
this. mServiceld.setServiceT ype(0); 
throw new RuntimeException("not implemented"); 


} 
/构造 函数 ， 使 用 给 定 的 ID 构造 一 个 新 的 低 功 耗 服 务 */ 
public BleServerService(BleGattID serviceld, byte supTransport, int numHandles) 
{ 
this.mServiceld = serviceld; 
this. mNumHandles = numHandles; 
this.mSupTransport = supTransport; 
this.mGattServiceCallback = new BleServiceCallback(this); 


this. mCharHdlMap = new HashMap(); 
this. mCharQueue = new ArrayList(); 
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this.mServiceHdlMap = new HashMap(); 
this.mAttrReqMap = new HashMap(); 


if (this.mServiceld.getServiceType() == -1) 
this.mServiceld.setServiceType(0); 
throw new RuntimeException("not implemented"); 


} 
”初始 化 服务 */ 
protected void initService() 


{ 


if (this.mService != null) 


try { 
this.mService.registerServerServiceCallback(this.mServiceld, 
this. mAppUuid, this.mGattServiceCallback); 
} catch (Throwable t) { 
Log.e("BleServerService", "initService", t); 


} 


} 
A* 注 册 服 务 到 蓝牙 协议 栈 */ 
public void createService() 


if (this.mService != null) 


try { 
this. mService.GATTServer_CreateService(this.mProfileHandle.getAppHandle(), 
this.mServiceld, this. mNumHandles); 
} catch (Throwable t) 


Log.e("BleServerService", "createService", t); 


) 


} 
性 从 蓝牙 协议 栈 注销 服务 ”/ 
public void deleteService() 


if (this.mService != null) 


try { 

this.mService.GATTServer. DeleteService(this.mSvcHandle); 
} catch (Throwable t) { 

Log.e("BleServerService", "deleteService ", t); 


} 


} 

l'RRIBRSS*I 
public void startService() 
{ 


if (this.mService != null) 


try { 

this.mService.GATTServer StartService(this.mSvcHandle, this. mSupTransport); 
} catch (Throwable t) { 

Log.e("BleServerService", "startService ", t); 


) 
) 
让 停止 服务 */ 


(oe, 
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public void stopService() 
{ 
if (this.mService != null) { 
this.mProfileHandle.notifyAction(4); 
try { 
this.mService.unregisterServerServiceCallback(this.mSvcHandle); 
this.mService.GATTServer_StopService(this.mSvcHandle); 
} catch (Throwable t) { 
Log.e("BleServerService", "stopService ", t); 
) 
} 


} 
/* 为 此 服务 添加 一 个 包含 的 服务 */ 
public void addIncludedService(BleServerService service) 


if (this. mService != null) 
try { 
if (service.isRegistered()) ( 
this.mServiceHdlMap.put(Integer.valueOf(service.getServiceHandle()), 
service); 
this. mService.GATTServer_AddincludedService(this.mSvcHandle, 
service.getServiceHandle()); 
} 
else { 
Log.i("BleServerService", 
"addincludedService: Service to be included is not registered."); 


} 
} catch (Throwable t) { 
Log.e("BleServerService", "addIncludedService", t); 


} 


} 
/更 新 一 个 特性 或 描述 符 ” 
public void updateCharacteristic(BleCharacteristic charObj) 


addCharacteristic(charObj); 


} 
РАР RRRS -AER IRE I E — 1 9 EI 
public void sendResponse(String address, int transld, byte[] data, int statusCode) 
( 
Log.d("BleServerService", "sendResponse() address = "+ address + ", transld =" 
+ transld + ",statusCode = " + statusCode); 


if (this.mService == null) { 
Log.e("BleServerService", "sendResponse(): error. GattService not available"); 
return; 


} 


AttributeRequestinfo attrinfo = (AttributeRequestinfo) this.mAttrReqMap 
.remove(Integer.valueOf(transld)); 

if (attrinfo == null) 

{ 
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Log.e("BleServerService", 
"ѕепабеѕропѕе() error. attrinfo not found with transld " + transld); 
return; 


) 


byte[] dataToSend = null; 

if (attrinfo.mOffset == 0) { 
dataToSend - data; 

} else { 
dataToSend = new byte[data.length - attrinfo.mOffset]; 
System.arraycopy(data, attrinfo.mOffset, dataToSend, 0, dataToSend.length); 


} 

try 

{ 

this.mService 
.GATTServer_SendRsp( 

attrinfo.mConnid, 
attrinfo.mTransld, 
(byte) statusCode, 
attrinfo.mAttrHandle, 
attrinfo.mOffset, 
dataToSend, 
(byte) 0, 
false); 

} catch (Throwable t) 


Log.e("BleServerService", "sendResponse(): error", t); 


} 


} 
让 当 客户 端 已 经 请 求 读 或 写 一 个 本 地 特性 属性 后 发 送 一 个 响应 */ 
public void sendResponse(String address, int transld, int handle, int offset, byte[] data, 
int statusCode, boolean isWrite) 
( 
int connld = getConnld(address); 
if ((connld != -1) && (this.mService !- null)) 


try { 
this.mService.GATTServer. SendRsp(connld, transld, (byte) statusCode, 


handle, offset, data, (byte) 0, isWrite); 
} catch (Throwable t) 
{ 


} 
} 
人 * 当 本 地 属性 改变 时 发 送 一 个 通知 给 客户 端 */ 


public void sendNotification(String address, int attrHandle, byte[] value) 
{ 


Log.e("BleServerService", "ѕепабеѕропѕе", t); 


int connld = getConnld(address); 
if ((connld != -1) && (this.mService !- null)) 
try { 


this.mService 
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-GATTServer HandleValueNotification(connld, attrHandle, value); 
} catch (Throwable t) ( 
Log.e("BleServerService", "sendNotification", t); 


} 


} 
3—17] PUR 
public void sendIndication(String address, int attrHandle, byte[] value) 


{ 
int connld = getConnld(address); 
if ((connld != -1) && (this.mService != null)) 
try { 
this. mService.GATTServer_HandleValuelndication(connid, attrHandle, value); 
} catch (Throwable t) { 
Log.e("BleServerService", "sendindication", t); 
} 
} 
* 添 加 新 特性 到 此 服务 */ 


private void addCharacteristic(BleCharacteristic charObj, boolean addtoQueue) { 
Log.i("BleServerService", "GATTServer_AddCharacteristic"); 
ArrayList dirtyDescQueue = charObj.getDirtyDescQueue(); 


if (this. mService == null) || (charObj == null) || (charObj.getID() == null)) ( 
Log 
.i("BleServerService", 
"GattService/Characteristic object passed in is null.. Cannot add the chanaracteristic..."); 
return; 


} 
try 
{ 
if (charObj.isRegistered()) { 
Log.d("BleServerService", "Starting to add descriptors, dirtyDesc size =" 
+ dirtyDescQueue.size()); 


boolean dirtyMask = charObj.isDirty(); 
if (IdirtyDescQueue.isEmpty()) 


{ 
BleDescriptor descObj = (BleDescriptor) dirtyDescQueue.get(0); 
Log.i("BleServerService", "GATTServer_AddCharDescriptor"); 
this. mService.GATTServer_AddCharDescriptor(this.mSvcHandle, 
descObj.getPermission(), descObj.mID); 
} 


else if (dirtyMask) { 
Log.i("BleServerService", "GATTServer_AddCharValue"); 
HashMap<String, Integer> connMap = this.mProfileHandle.getConnMap(); 


int clientCfg; 

for (Map.Entry<String, Integer> entry : connMap.entrySet()) { 
String address = (String) entry.getKey(); 
int connld = ((Integer) entry.getValue()).intValue(); 
clientCfg = 0; 
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return; 
} 
}еіѕе { 
if (addtoQueue) { 
synchronized (this) { 
this. mCharQueue.add(charOb)j); 
Log.e("BleServerService", 
"Adding a new characteristic... SIZE IS " + this.mCharQueue.size() 
+ "Uuid=" + charObj.getID()); 


if (this. mCharQueue.size() > 1) 
return; 


} 


} 

BleGattID uuid = charObj.getlD(); 

this.mService.GATTServer, AddCharacteristic(this.mSvcHandle, uuid, 
charObj.getPermission(), charObj.getProperty(), charObj.isDirty(), 
dirtyDescQueue.size()); 


} 
} catch (Throwable t) 
Log.e("BleServerService", "addCharacteristic", t); 


) 


/这 是 一 个 回调 函数 ， 当 添加 一 个 包含 的 服务 时 触发 
public void onIncludedServiceAdded(byte status, BleServerService includedService) 


Log.d("BleServerService", "OnIncludedServiceAdded : status=" + status 
+ "Included service" + includedService.getUuid()); 


} 
/ 当 添 加 一 个 特性 时 调用 
public void onCharacteristicAdded(byte status, BleCharacteristic charObj) 
{ 
Log.d("BleServerService", "OnCharacteristicAdded : Characteristic uuid = " 
+ charObj.getlD() + "status="+ status); 


} 

ЕЕН BARA 
public void onResponseSendCompleted(byte status, BleCharacteristic charObj) 
{ 


Log.d("BleServerService", "onResponseSendCompleted : status=" + status); 


} 
"这 是 一 个 回调 函数 ， 当 添加 一 个 特性 时 调用 */ 
public void onCharacteristicRead(String address, int transld, int attrHandle, 
BleCharacteristic charObj) 

{ 

AttributeRequestinfo attrinfo = (AttributeRequestinfo) this.mAttrReqMap 
.remove(Integer.valueOf(transld)); 

Log.d("BleServerService", "Inside onCharacteristicRead()"); 
if (attrinfo == null) 
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{ 
Log.e("BleServerService", 
"onCharacteristicRead() error. attrinfo not found with transld " + transld); 
return; 
} 
if (charObj == null) 
{ 
Log.e("BleServerService", "onCharacteristicRead() error. charObj is null"); 
return; 
) 
byte[] data = charObj.getValueByHandle(attrHandle); 
if (data == null) ( 
Log.d("BleServerService", "Attribute not found with handle " + attrHandle); 
try 
{ 
this. mService.GATTServer_SendRsp(attrinfo.mConnid, 
attrinfo.mTransld, 
(byte) 10, 
attrinfo.mAttrHandle, 
attrinfo.mOffset, null, 
(byte) 0, 
false); 
} catch (Throwable t) 
Log.e("BleServerService", "onCharacteristicRead(): error", t); 
} 
return; 


} 
int dataLength = data == null ? 0 : data.length; 
if (attrinfo.mOffset >= dataLength) { 


Log.e("BleServerService", 
"onCharacteristicRead() error. dataLength < attrInfo.mOffset"); 


try 
{ 
this. mService.GATTServer_SendRsp( 
attrinfo.mConnid, 
attrinfo.mTransid, 
(byte) 7, 
attrinfo.mAttrHandle, 
attrinfo.mOffset, 
null, 
(byte) 0, 
false); 
} catch (Throwable t) 
{ 
Log.e("BleServerService", "onCharacteristicRead(): error", t); 
| 
return; 


201 


DO Android 4 BERUF ACA 18132 


) 


byte[] dataToSend = null; 

if (attrinfo.mOffset == 0) ( 
dataToSend - data; 

} езе { 
dataToSend = new byte[data.length - attrinfo.mOffset]; 
System.arraycopy(data, attrinfo.mOffset, dataToSend, 0, dataToSend.length); 


} 
try 
{ 
this. mService.GATTServer_SendRsp(attrinfo.mConnld, attrinfo.mTransld, (byte) 0, 
attrinfo.mAttrHandle, attrinfo.mOffset, dataToSend, (byte) 0, false); 
} catch (Throwable t) 
{ 
Log.e("BleServerService", "sendResponse(): error", t); 
} 


} 
/这 是 一 个 回调 函数 ， 当 特性 的 写 操作 完成 时 被 触发 "/ 
public void onCharacteristicWrite(String address, BleCharacteristic charObj) 
{ 
Log.d("BleServerService", "onCharacteristicWrite : modified characteristic=" 
+ charObj.getID()); 
} 


private class BleServiceCallback extends IBleServiceCallback.Stub { 
private BleServerService mGattService; 


public BleServiceCallback(BleServerService service) { 
this.mGattService = service; 
} 
EARS"! 
public void onServiceRegistered(byte status, BluetoothGattlD svcld) { 
Log.i("BleServerService", "onServiceRegistered"); 
if (status == 0) 
{ 
this.mGattService.setServicelnstance(svcld.getlnstancelD()); 
this.mGattService.createService(); 
) else ( 
Log.e("BleServerService", "#######Service registration failed..."); 
BleServerService.this.mProfileHandle.notifyAction(1); 


} 
让 创建 服务 */ 
public void onServiceCreated(byte status, int svcHandle) ( 
Log.i("BleServerService", "onServiceCreated"); 
if (status == 0) { 
this.mGattService.setServiceHandle(svcHandle); 
BleServerService.this.mProfileHandle.notifyAction(0); 
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}else{ 
BleServerService.this.mProfileHandle.notifyAction(1); 
} 


} 
Ст) 描述 低 功 耗 蓝牙 服务 的 特性 
在 Broadcom 公司 提供 的 源码 中 , 文件 BleCharacteristic.java 的 功能 是 描述 低 功 耗 蓝 牙 服务 的 特性 。 
在 特性 中 包含 了 描述 符 、 实 际 值 和 元 数据 , 提供 了 表现 格式 或 便于 阅读 值 的 描述 。 文 件 BleCharacteristic. 
java 的 主要 实现 代码 如 下 : 
/获取 GATT 的 ID 值 */ 
private BleGattID getBleGattld(int handle) 


for (Map.Entry<BleGattID, Integer» entry : mHandleMap.entrySet()) { 
if (handle == entry.getValue().intValue()) ( 
return entry.getKey(); 
} 


return null; 
} 
p 
* 返 回 该 特征 的 实例 的 ID 
* 实 例 ID 的 BLE 配置 文件 和 服务 用 于 标识 属于 一 个 给 定 的 实例 的 服务 或 轮廓 的 特征 
ji 
public int getlnstancelD() 
return mID.getInstancelD(); 
) 
p 
* 指 定 一 个 实例 ID 的 这 一 特性 


*@see {@link #getInstancelD()} 
T 
public void setInstancelD(int instancelD) 


mlID.setinstanceld(instancelD); 


) 


p 
“根据 特性 向 一 个 给 定 的 偏 移 量 设置 原始 值 的 字 节 
10 


public byte setValue(byte[] value, int offset, int len, int handle, int totalsize, 


String address) 
{ 
int uuid = -1; 
int uuidType = -1; 


Log.e("BleCharacteristic", "#### handle is " + handle + " total size is " + totalsize); 


BleGattID gattUuid = getBleGattld(handle); 
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if (gattUuid == null) { 
Log.e("BleCharacteristic", "setValue: Invalid handle"); 
return BleConstants.GATT INVALID HANDLE; 

} 


if (gattUuid.equals(mID)) ( 
Log.i("BleCharacteristic", "##Writing a characteristic value.."); 
Log.i("BleCharacteristic", "##offset=" + offset + " mMaxLength=" 
+ mMaxLength + " totalsize=" + totalsize); 
return setValue(value, offset, len, gattUuid, totalsize, address); 


BleDescriptor descObj = mDescriptorMap.get(gattUuid); 
if (descObj != null) { 
Log.i("BleCharacteristic", "##Writing descriptor value.."); 
Log.i("BleCharacteristic", 
"##offset=" + offset + " mMaxSize-" + descObj.getMaxLength() + " totalsize=" 
+ totalsize + "desc иша =" + descObj.getlD()); 
if (offset > descObj.getMaxLength()) 
return BleConstants.GATT_INVALID_OFFSET; 
if (offset + totalsize > descObj.getMaxLength()) 
return BleConstants.GATT_INVALID_ATTR_LEN; 
Log.i("BleCharacteristic", "find the user defined descriptor "); 
return descObj.setValue(value, offset, len, gattUuid, totalsize, address); 


Log.e("BleCharacteristic", "Failed to write the value correctly!!!"); 
return -127; 


} 


p 
* 一 个 给 定 的 偏 移 量 设置 原始 值 的 字 节 

'/ 

@Override 

public byte setValue(byte[] value, int offset, int len, BleGattID gattUuid, int totalsize, String address) 
{ 


} 


p 
*Gets the characteristic properties value (bit field). 
st 

public int getProperty() 

{ 


} 


p 
“设置 特性 属性 集 

Т 

public void setProperty(int Prop) 
{ 


(m, 


return super.setValue(value, offset, len, gattUuid, totalsize, address); 


return mProp; 


mProp = Prop; 
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} 


p 
* 获 取 一 个 基于 UUID 的 描述 符 

Sl 

public BleDescriptor getDescriptor(BleGattlD descriptor) 


{ 
BleDescriptor descObj = mDescriptorMap.get(descriptor); 
if (descObj != null) { 
return descObj; 
} 
return null; 
} 
p. 
* 添 加 一 个 描述 符 对 象 
ah 
public void addDescriptor(BleGattID descld, BleDescriptor descriptor) 
{ 
Log.d("BleCharacteristic", "Inside add descriptor"); 
mDescriptorMap.put(descld, descriptor); 
mDirtyDescQueue.add(descriptor); 
descriptor.setCharRef(this); 
} 
p 


* 添 加 一 个 描述 符 对 象 
i] 
public void addDescriptor(BleDescriptor descriptor) 


{ 
mDescriptorMap.put(descriptor.mID, descriptor); 
mDirtyDescQueue.add(descriptor); 
descriptor.setCharRef(this); 

} 

p 


“返回 所 有 用 户 定义 的 都 包含 在 这 一 特性 数组 描述 符 
ot 
public ArrayList<BleDescriptor> getAllDescriptors() 
{ 
ArrayList<BleDescriptor> descList = new ArrayList<BleDescriptor>(); 
for (Map.Entry<BleGattID, BleDescriptor> entrySet : mDescriptorMap.entrySet()) { 
descList.add(entrySet.getValue()); 
} 
return descList; 


} 
p 


“映射 这 个 属性 句柄 值 属性 
sp 


= 
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public void addHandle(BleGattID uuid, int handle) 
{ 


} 


pt 
* 返 回 一 个 对 给 定 属性 ID 的 处 理 结果 
public int getHandle(BleGattID иша) 
{ 


mHandleMap.put(uuid, Integer.valueOf(handle)); 


Integer tmp; 

if ((tmp = mHandleMap.get(uuid)) != null) { 
return tmp.intValue(); 

} 


return -1; 


} 


p 
“设置 所 需 的 读 / 写 这 个 属性 的 验证 水 平 
I 

@Override 

public void setAuthReq(byte AuthReq) 


mAuthReq = AuthReq; 
} 


p 
* 返 回 是 否 允 许 签 写 这 个 特性 

n 

public boolean isAuthenticated() 


{ 
return (mProp & BleConstants.GATT_CHAR_PROP_BIT_AUTH) == BleConstants.GATT_CHAR_ 


PROP_BIT_AUTH; 


} 
p. 
“返回 一 个 基于 先前 分 配 的 句柄 值 这 一 特性 属性 
yi 
@Override 
public byte[] getValueByHandle(int handle) 
{ 
BleGattID gattUuid = getBleGattld(handle); 
if (gattUuid == null) { 
Log.w("BleCharacteristic", "Attribute UUID not found with handle " + handle); 
return null; 
} 
int uuidType = gattUuid.getUuidType(); 
if (uuidType == BleConstants.GATT_UUID_TYPE_16) 
return getValueByUUID16(gattUuid); 
if (uuidType == BleConstants.GATT_UUID_TYPE_128) { 
return getValueByUUID128(gattUuid); 
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Log.w("BleCharacteristic", "Invalid UUID type."); 
return null; 


} 


pt 
* 检 索 一 个 基于 16 位 UUID 这 个 特征 的 属性 
WI 
public byte[] getValueByUUID16(BleGattlD uuid) 
{ 
int uuid16 = uuid.getUuid16(); 
if (uuid16 == -1) { 
Log.w("BleCharacteristic", "Invalid UUID16."); 
return null; 


} 
int thisAttrUuid16 = mID == null ? -1 : mID.getUuid16(); 
if (uuid16 == thisAttrUuid16) 


return getValue(); 


} 

BleDescriptor descObj = mDescriptorMap.get(uuid); 

if (descObj != null) { 
Log.d("BleCharacteristic", "Descriptor UUID =" + descObj.getID().getUuid16()); 
return descObj.getValue(); 


} 
Log.w("BleCharacteristic", "Attribute query not supported for uuid16 value " 
* uuid16); 

return null; 

} 

p 

* 检 索 一 个 基于 128 位 ОШО 这 个 特征 的 属性 */ 
public byte[] getValueByUUID128(BleGattID uuid) 


UUID uuid128 = uuid.getUuid(); 
if (uuid128 == null) ( 
return null; 


} 
if ((mID != null) && (uuid128.equals(mID.getUuid()))) { 
return getValue(); 


} 

BleDescriptor descObj = mDescriptorMap.get(uuid); 

if (descObj != null) { 

return descObj.getValue(); 

} 

Log.w("BleCharacteristic", "Attribute query not supported for uuid128 value " 
+ uuid128); 

return null; 

) 
} 


(8) 低 功 耗 描述 符 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleDescriptorjava 是 BleCharacteristic 的 一 部 分 ， 功 能 是 定 
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义 了 一 个 低 功 耗 描 述 符 。 文 件 BleDescriptor.java 的 主要 实现 代码 如 下 : 
public class BleDescriptor extends BleAttribute 
implements Parcelable 


{ 
private static final String TAG = "BleDescriptor"; 
private BleCharacteristic mCharObj; 
protected HashMap<String, Integer» mClientctgMap = new HashMap(); 


~ @hide */ 
@SuppressWarnings({ 
"unchecked", "rawtypes" 
» 
public static final Parcelable.Creator<BleDescriptor> CREATOR = new Parcelable.Creator() 
{ 
public BleDescriptor createFromParcel(Parcel source) { 
return new BleDescriptor(source); 
} 
public BleDescriptor[] newArray(int size) 
{ 


} 


return new BleDescriptor[size]; 


E 
p 
* 从 一 个 给 定 的 偏 移 设置 原始 值 字 节 的 描述 符 
* @return {@link BleConstants#GATT_SUCCESS if successful} 
sli 
@Override 
public byte setValue(byte[] value, int offset, int length, BleGattID gattUuid, 
int totalSize, String address) 
{ 
int uuidType = gattUuid.getUuidType(); 
int uuid = -1; 
Log.e("BleDescriptor", "##### UUID type=" + gattUuid.getUuidType()); 
if (uuidType == 2) { 
uuid = gattUuid.getUuid16(); 


if (uuid == -1) { 
Log.e("BleDescriptor", "setValue: Invalid handle (UUID16 not found)"); 
return 1; 

) 


} 
if (uuid == 10500) ( 
Log.i("BleDescriptor", "##Writing a Presentation format.."); 
} else if (uuid == 10498) ( 
Log.i("BleDescriptor", "##Writing a characteristic client config"); 
if (totalSize > this. mMaxLength) 
return 13; 
int valuelnt = 0; 
for (int i = 0; i < length; i++) { 
int shift = (length - 1 - i) * 8; 
valuelnt += ((value[i] & OxFF) << shift); 


(m, 
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this.mClientcfgMap.put(address, Integer.valueOf(valuelnt)); 
} else if (gattUuid.equals(this.mID)) { 
Log.i("BleDescriptor", "Writing a descriptor value.."); 
Log.i("BleDescriptor", "##offset=" + offset + " mMaxLength=" + this.mMaxLength 
+" length=" + length); 
super.setValue(value, offset, length, gattUuid, totalSize, address); 
this.mDirty = true; 
return 0; 
} 
} 
C9) 标识 低 功 耗 蓝牙 规范 、 服 务 和 特性 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleGattlD java 的 功能 是 定义 了 一 个 标识 低 功 耗 蓝牙 规范 、 
服务 和 特性 的 类 ， 此 类 使 用 16 位 或 128 位 的 UUIDs 来 标识 一 个 给 定 的 低 功 耗 蓝牙 实体 ， 这 个 实体 包 
含 规范 、 服 务 和 特性 。 文 件 BleGattID.java 的 主要 实现 代码 如 下 : 
p 
* 标 识 一 个 蓝牙 GATT 特性 或 属性 
ч 
public final class BleGattID extends BluetoothGattID 
implements Parcelable 


É 
private static final String BASE_UUID_TPL = "%08x-0000-1000-8000-00805f9b34fb"; 
@SuppressWarnings({ 
"rawtypes", "unchecked" 
» 
public static final Parcelable.Creator<BleGattID> CREATOR = new Parcelable.Creator() { 
public BleGattID createFromParcel(Parcel source) { 
int instld = source.readint(); 
int type = source.readint(); 
int serviceType = source.readint(); 


if (type == 16) { 
String sUuid = source.readString(); 
return new BleGattlD(instld, sUuid, serviceType); 
} 
int uuid = source.readint(); 
return new BleGattlD(instld, uuid, serviceType); 


) 
public BleGattID[] newArray(int size) 
{ 
return new BleGattlD[size]; 
) 


E 
(10) 为 远程 蓝牙 设备 提供 额外 信息 
在 Broadcom 公司 提供 的 源码 中 ， 文 件 BleAdapterjava 的 功能 是 为 远程 蓝牙 设备 提供 额外 的 信息 ， 
能 够 判断 远程 设备 是 否 是 低 功 耗 设备 、BR/EDR 传统 蓝牙 设备 或 双 模 设 备 〈 同 时 支持 低 功 耗 和 传统 设 
备 )。 文 件 BleAdapterjava 的 主要 实现 代码 如 下 : 
x) 
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p 
* 提 供 帮 助 的 功能 和 相关 的 常数 扩展 蓝牙 功能 的 低能 耗 信息 
si 

public class BleAdapter 

{ 

private static final String TAG = "BleAdapter"; 
private static final boolean D = true; 


private static final int API LEVEL = 5; 
private static IBluetoothGatt mService; 
private GattServiceConnection mSvcConn; 
private Context mContext; 


p. 
* 设置 远程 ACTION_FOUND 设备 的 额外 信息 


* @see {@link $DEVICE TYPE BREDR), {@link #DEVICE_TYPE_BLE}, 
* {@link #ОЕМІСЕ ТҮРЕ ООМО} 
+) 
public static final String EXTRA DEVICE TYPE = "android.bluetooth.device.extra.DEVICE TYPE"; 


public static final byte DEVICE TYPE BREDR = 1; 


public static final byte DEVICE TYPE BLE = 2; 
public static final byte DEVICE TYPE DUMO = 3; 
public static final String ACTION UUID = "android.bluetooth.le.device.action. UUID"; 
public static final String EXTRA ООО = "android.bluetooth.le.device.extra. UUID"; 
public static final String EXTRA DEVICE = "android.bluetooth.le.device.extra.DEVICE"; 
private static boolean startService() ( 
if (mService != null) 
return true; 
IBinder service = ServiceManager.getService(BleConstants.BLUETOOTH LE SERVICE); 
if (service != null) 
mService - IBluetoothGatt.Stub.asInterface(service); 
return mService !- null; 


p. 
* 构建 一 种 新 的 BleAdapter 对 象 
public BleAdapter(Context ctx) { 
this.mContext = ctx; 
if (startService()==false) 
throw new RuntimeException("failed connecting to service"); 
this.init(); 
^ 
p 
* 返回 蓝牙 设备 的 类 型 (LE、BR/EDR or dual-mode) 


* @param device - The remote device who's type is to be determined 

* @return The type of the remote device 

* see {@link sDEVICE TYPE, BREDR], {@link #DEVICE_TYPE_BLE}, 
š (@link #DEVICE_TYPE_DUMO) 
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F 
public static byte getDeviceType(BluetoothDevice device) 


{ 
if (IstartService()) 
throw new RuntimeException("service not available"); 
if (device != null) { 
try { 
return mService.getDeviceType(device.getAddress()); 
} catch (RemoteException e) { 
Log.e(TAG, "error", e); 
} 
} 
return 0; 
} 
p. 


* 启动 远程 设备 中 的 蓝牙 服务 ， 发 现 使 用 {@link #ACTION_UUID} 的 意图 


* @param deviceAddress - Bluetooth address of the remote device in 
00:11:22:33:44:55 format 
* @return true if the device discovery was started successfully 
| 
public static boolean getRemoteServices(String deviceAddress) 


if (IstartService()) 

throw new RuntimeException("service not available"); 
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter(); 
if (adapter == null) 

return false; 
try { 

mService.getUUIDs(deviceAddress); 

return true; 
} catch (RemoteException e) { 

e.printStackTrace(); 

if (D) 

Log.e(TAG, "error", е); 

} 


return false; 


p. 
* 初始 化 BleAdapter 对 象 ， 连 接 蓝 牙 GATT 服务 失效 回调 
* 
/ 
public void init() 
{ 
pt 
* TODO: implement 
9 
Log.d("BleAdapter", "init"); 
Intent i = new Intent(); 
i.setclassName("com.broadcom.bt.app.system", "com.broadcom.bt.app.system.GattService"); 
mContext.bindService(i, mSvcConn, 1); 
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量 , 这 些 常 量 用 于 表示 各 种 和 实现 低 功 耗 功能 函数 的 属性 和 返回 值 。 文件 BleConstants java 的 3 


(11) 保存 和 GATT 相关 的 常量 


在 Broadcom 公司 提供 的 源码 中 , 文件 BleConstants java 的 功能 是 定义 保存 各 种 和 GATT 相关 的 常 


代码 如 下 : 


public abstract class BleConstants 
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public static final int GATT_UNDEFINED = -1; 


public static final int GATT_SERVICE_CREATION_SUCCESS = 0; 
public static final int GATT_SERVICE_CREATION_FAILED = 1; 
public static final int GATT_SERVICE_START_SUCCESS = 2; 


public static final int GATT_SERVICE_START_FAILED = 3; 
public static final int GATT_SERVICE_STOPPED = 4; 
public static final int SERVICE_UNAVAILABLE = 1; 

public static final int GATT_SERVICE_PRIMARY = 0; 
public static final int GATT_SERVICE_SECONDARY = 1; 


public static final int GATT_SERVER_PROFILE_INITIALIZED = 0; 


public static final int GATT_SERVER_PROFILE_UP = 1; 
public static final int GATT_SERVER_PROFILE_DOWN = 2; 
public static final int GATT_SUCCESS = 0; 

public static final int GATT_INVALID_HANDLE = 1; 

public static final int GATT_READ_NOT_PERMIT = 2; 
public static final int GATT_WRITE_NOT_PERMIT = 3; 
public static final int GATT_INVALID_PDU = 4; 

public static final int GATT_INSUF_AUTHENTICATION = 5; 
public static final int GATT_REQ_NOT_SUPPORTED = 6; 
public static final int GATT INVALID OFFSET = 7; 

public static final int GATT INSUF AUTHORIZATION - 8; 
public static final int GATT PREPARE О FULL = 9; 
public static final int GATT NOT. FOUND = 10; 

public static final int GATT NOT. LONG = 11; 

public static final int GATT INSUF. KEY SIZE = 12; 

public static final int GATT INVALID ATTR LEN = 13; 
public static final int GATT ERR. UNLIKELY = 14; 

public static final int GATT INSUF ENCRYPTION = 15; 
public static final int GATT UNSUPPORT GRP TYPE - 16; 
public static final int GATT INSUF RESOURCE = 17; 
public static final int GATT ILLEGAL PARAMETER = 135; 
public static final int GATT NO RESOURCES = 128; 
public static final int GATT INTERNAL, ERROR = 129; 
public static final int GATT WRONG STATE - 130; 

public static final int GATT DB FULL = 131; 

public static final int GATT BUSY = 132; 

public static final int GATT ERROR = 133; 

public static final int GATT CMD. STARTED = 134; 

public static final int GATT_PENDING = 136; 

public static final int GATT AUTH FAIL = 137; 

public static final int GATT MORE = 138; 

public static final int GATT INVALID CFG = 139; 

public static final byte GATT AUTH REQ NONE - 0; 
public static final byte GATT AUTH REQ NO MITM = 1; 


要 实现 
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public static final byte GATT_AUTH_REQ_MITM = 2; 

public static final byte GATT_AUTH_REQ_SIGNED_NO_MITM = 3; 
public static final byte GATT_AUTH_REQ_SIGNED_MITM = 4; 
public static final int GATT_PERM_READ = 1; 

public static final int GATT_PERM_READ_ENCRYPTED = 2; 

public static final int GATT_PERM_READ_ENC_MITM = 4; 

public static final int GATT_PERM_WRITE = 16; 

public static final int GATT_PERM_WRITE_ENCRYPTED = 32; 
public static final int GATT_PERM_WRITE_ENC_MITM = 64; 

public static final int GATT_PERM_WRITE_SIGNED = 128; 

public static final int GATT_PERM_WRITE_SIGNED_MITM = 256; 
public static final byte GATT_CHAR_PROP_BIT_BROADCAST = 1; 
public static final byte GATT_CHAR_PROP_BIT_READ = 2; 

public static final byte GATT_CHAR_PROP_BIT_WRITE_NR = 4; 
public static final byte GATT_CHAR_PROP_BIT_WRITE = 8; 

public static final byte GATT_CHAR_PROP_BIT_NOTIFY = 16; 
public static final byte GATT_CHAR_PROP_BIT_INDICATE = 32; 
public static final byte GATT_CHAR_PROP_BIT_AUTH = 64; 

public static final byte GATT_CHAR_PROP_BIT_EXT_PROP = -128; 
public static final byte SVC_INF_INVALID = -1; 

public static final int GATTC_TYPE_WRITE_NO_RSP = 1; 

public static final int GATTC_TYPE_WRITE = 2; 

public static final int GATT_FORMAT_RES = 0; 

public static final int GATT_FORMAT_BOOL = 1; 

public static final int GATT_FORMAT_2BITS = 2; 

public static final int GATT_FORMAT_NIBBLE = 3; 

public static final int GATT_FORMAT_UINT8 = 4; 

public static final int GATT_FORMAT_UINT12 = 5; 

public static final int GATT_FORMAT_UINT16 = 6; 
public static final int GATT_FORMAT_UINT24 = 7 
public static final int GATT FORMAT. UINT32 = 8; 
public static final int GATT FORMAT. UINTA8 = 9; 
public static final int GATT FORMAT. UINT64 = 10; 
public static final int GATT FORMAT. UINT128 = 11; 
public static final int GATT FORMAT. SINT8 = 12; 
public static final int GATT FORMAT. SINT12 = 13; 
public static final int GATT FORMAT, SINT16 = 14; 
public static final int GATT FORMAT. SINT24 = 15; 
public static final int GATT FORMAT. SINT32 = 16; 
public static final int GATT FORMAT. SINTA48 = 17; 
public static final int GATT FORMAT. SINT64 - 18; 
public static final int GATT FORMAT SINT 128 = 19; 
public static final int GATT FORMAT FLOAT32 - 20; 
public static final int GATT FORMAT FLOAT64 = 21; 
public static final int GATT FORMAT SFLOAT - 22; 
public static final int GATT FORMAT. FLOAT = 23; 
public static final int GATT FORMAT DUINT16 = 24; 
public static final int GATT FORMAT UTF8S = 25; 
public static final int GATT FORMAT ОТР165 = 26; 
public static final int GATT FORMAT. STRUCT = 27; 
public static final int GATT FORMAT MAX - 28; 
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} 


public static final String GATT_UUID_CHAR_EXT_PROP = "00002900-0000-1000-8000-00805f9b34fb"; 
public static final String GATT_UUID_CHAR_DESCRIPTION = "00002901-0000-1000-8000-00805f9b34fb"; 
public static final String GATT_UUID_CHAR_CLIENT_CONFIG = "00002902-0000-1000-8000-00805f9b34fb"; 
public static final String GATT_UUID_CHAR_SRVR_CONFIG = "00002903-0000-1000-8000-00805f9b34fb"; 
public static final String GATT UUID CHAR PRESENT FORMAT = "00002904-0000-1000-8000-00805f9b34fb"; 
public static final String GATT UUID CHAR. АСО FORMAT = "00002905-0000-1000-8000-00805f9b34fb". 
public static final int GATT UUID CHAR EXT PROP16 = 10496; 

public static final int GATT UUID CHAR, DESCRIPTION16 = 10497; 

public static final int GATT UUID CHAR CLIENT CONFIG16 = 10498; 

public static final int GATT UUID CHAR. SRVR, CONFIG16 = 10499; 

public static final int GATT UUID CHAR PRESENT FORMAT (16 = 10500; 

public static final int GATT UUID CHAR AGG FORMAT(16 = 10501; 

public static final int GATT TRANSPORT BREDR LE = 2; 

public static final int GATT TRANSPORT BREDR = 1; 

public static final int GATT_TRANSPORT_LE = 0; 

public static final int GATT_UUID_TYPE_128 = 16; 

public static final int GATT_UUID_TYPE_32 = 4; 

public static final int GATT_UUID_TYPE_16 = 2; 

public static final int PREPARE QUEUE SIZE = 200; 

public static final int GATT MAX CHAR VALUE LENGTH - 100; 

public static final int GATT CLIENT CONFIG NOTIFICATION BIT = 1; 

public static final int GATT CLIENT CONFIG INDICATION BIT = 2; 

public static final int GATT INVALID CONN ID = 65535; 

public static final int VALUE. DIRTY = 1; 

public static final int USER DESCRIPTION DIRTY = 2; 

public static final int EXT. PROP. DIRTY = 4; 

public static final int PRESENTATION FORMAT DIRTY = 8; 

public static final int CLIENT CONFIG DIRTY 7 16; 

public static final int SERVER CONFIG DIRTY = 32; 

public static final int AGGREGATED FORMAT DIRTY = 64; 

public static final int USER DESCRIPTOR DIRTY = 128; 

public static final int ALL DIRTY = 127; 

public static final byte GATT ENCRYPT NONE = 0; 

public static final byte GATT ENCRYPT = 1; 

public static final byte GATT ENCRYPT NO MITM = 2; 

public static final byte GATT ENCRYPT. MITM = 3; 

static final String ACTION OBSERVE RESULT = "com.broadcom.bt.app.gattL. OBSERVE RESULT"; 
static final String ACTION OBSERVE COMPLETED = "com.broadcom.bt.app.gatt.OBSERVE COMPLETED"; 
static final String EXTRA ADDRESS = "ADDRESS"; 

static final String EXTRA, ADDR TYPE = "ADDR TYPE"; 

static final String EXTRA RSSI = "RSSI"; 

static final String EXTRA ADV. DATA = "ADV. DATA"; 

static final String EXTRA NUM RESULTS = "NUM RESULTS"; 

static final String GATT SVC РКО NAME = "com.broadcom.bt.app.system"; 

static final String GATT SVC NAME = "com.broadcom.bt.app.system.GattService"; 


public static final String BLUETOOTH LE SERVICE = "com.manuelnaranjo.btle": 


至 此 ，Broadcom 公司 推出 的 低 功 耗 蓝 牙 协 议 栈 BlueDroid 的 开发 文档 和 API 源码 分 析 完毕 。 因 为 
本 书 篇 幅 的 限制 ， 只 是 分 析 了 主要 的 模块 类 ， 其 他 类 的 实现 代码 的 功能 和 原理 请 读者 参阅 其 源码 中 的 
注释 说 明 。 
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第 6 章 语音 识别 技术 详解 


语音 识别 是 一 门 交 叉 学 科 ， 经 过 多 年 的 发 展 ， 语 音 识 别 技术 取得 了 显著 进步 ， 逐 渐 从 实验 室 走向 
市 场 。 据 专家 预计 ， 在 未 来 10 年 内 ， 语 音 识别 技术 将 进入 工业 、 家 电 、 通 信 、 汽 车 电子 、 医 疗 、 家 庭 
服务 、 消 费 电 子 产 品 等 各 个 领域 。 很 多 专家 都 认为 语音 识别 技术 是 2000 一 2010 年 间 信 息 技术 领域 十 大 
重要 的 科技 发 展 技术 之 一 。 语 音 识别 技术 是 Android SDK 中 比较 重要 且 比 较 新 颖 的 一 项 技术 ， 在 
Android 穿戴 设备 应 用 中 可 以 通过 语音 来 控制 设备 。 本 章 将 详细 讲解 在 Android 物 联网 设备 中 使 用 语音 
识别 技术 的 基本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


6. 语音 识别 技术 基础 


GA 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 6 章 \ 语 音 识 别 技术 基础 .avi 
语音 识别 技术 所 涉及 的 领域 包括 信号 处 理 、 模 式 识别 、 概 率 论 和 信息 论 、 发 声 机 理 和 听觉 机 理 、 
人 工 智能 等 。 本 节 将 详细 讲解 语音 识别 技术 的 基本 知识 。 


6.1.1 语音 识别 的 发 展 历史 


1952 年 ,贝尔 研究 所 Davis 等 研究 员 成 功 研制 了 世界 上 第 一 个 能 识别 10 个 英文 数字 发 音 的 实验 系统 。 

1960 年 ， 英 国 的 Denes 等 人 研究 成 功 了 世界 上 第 一 个 计算 机 语音 识别 系统 。 

1970 年 以 后 ， 大 规模 的 语音 识别 得 到 了 良好 的 发 展 契 机 ， 在 小 词汇 量 、 孤 立 词 的 识别 方面 取得 了 
实质 性 的 进展 。DARPA (Defense Advanced Research Projects Agency) 是 在 20 世纪 70 年 代 由 美国 国防 
部 远景 研究 计划 局 资助 的 一 项 10 年 计划 ， 其 旨 在 支持 语言 理解 系统 的 研究 开发 工作 。 

1980 年 以 后 ， 研 究 的 重点 逐渐 转向 大 词汇 量 、 非 特定 人 连续 语音 识别 。 在 研究 思路 上 也 发 生 了 重 
大 变化 , 即 由 传统 的 基于 标准 模板 匹配 的 技术 思路 开始 转向 基于 统计 模型 HMM) 的 技术 思路 。 此 外 ， 
再 次 提出 了 将 神经 网 络 技术 引入 语音 识别 问题 的 技术 思路 。 美 国 国防 部 远景 研究 计划 局 又 资助 了 一 项 
为 期 10 年 的 DARPA 战略 计划 ， 其 中 包括 噪声 下 的 语音 识别 和 会 话 〈 口 语 ) 识别 系统 ， 识 别 任务 设 定 
为 “(1000 单词 ) 连续 语音 数据 库 管理 ”。 

1981 年 ， 日 本 在 第 5 代 计 算 机 计划 中 提出 了 有 关 语音 识别 “输入 -输出 ”自然 语言 的 宏伟 目标 ， 虽 
然 没 能 实现 预期 目标 ， 但 是 有 关 语 音 识别 技术 的 研究 有 了 大 幅度 的 加 强 和 进展 。 

1987 年 起 ， 日 本 又 拟 出 新 的 国家 项 目 : 高 级 人 机 口语 接口 和 自动 电话 翻译 系统 。 

1990 年 以 后 ，DARPA 计划 仍 在 持续 进行 中 。 其 研究 重点 已 转向 识别 装置 中 的 自然 语言 处 理 部 分 ， 
识别 任务 设 定 为 “航空 旅行 信息 检索 ”。 并 且 在 20 世纪 90 年 代 ， 语 音 识别 的 系统 框架 方面 并 没有 什么 
重大 突破 。 但 在 语音 识别 技术 的 应 用 及 产品 化 方面 有 很 大 的 进展 。 


6.1.2 语音 识别 技术 的 发 展 历程 


目前 IBM 语音 研究 小 组 在 大 词汇 语音 识别 方面 处 于 领先 地 位 ,在 20 世纪 70 年 代 开 始 了 它 的 大 词 
汇 语音 识别 研究 工作 。AT&T 的 贝尔 研究 所 也 开始 了 一 系列 有 关 非 特定 人 语音 识别 的 实验 。 这 一 研究 
历经 10 年 ， 其 成 果 是 确立 了 如 何 制 作用 于 非特 定 人 语音 识别 的 标准 模板 的 方法 。 在 这 一 时 期 所 取得 的 
重大 进展 有 如 下 3 点 。 

OD 隐 式 马尔 科 夫 模型 (HMM) 技术 的 成 熟 和 不 断 完善 成 为 语音 识别 的 主流 方法 。 

(2) 以 知识 为 基础 的 语音 识别 的 研究 日 益 受到 重视 。 在 进行 连续 语音 识别 时 ， 除 了 识别 声学 信息 
外 ， 更 多 地 利用 各 种 语言 知识 ， 诸 如 构 词 、 名 法、 语义 、 对 话 背 景 方 面 等 知识 来 帮助 进一步 对 语音 作 
出 识别 和 理解 。 同 时 在 语音 识别 研究 领域 ， 还 产生 了 基于 统计 概率 的 语言 模型 。 

G) 人 工 神经 网 络 在 语音 识别 中 的 应 用 研究 的 兴起 。 在 这 些 研究 中 ， 大 部 分 采用 基于 反 向 传播 算 
ik (BP 算法 ) 的 多 层 感知 网 络 。 人 工 神经 网 络 具有 区 分 复杂 的 分 类 边界 的 能 力 ， 显 然 它 十 分 有 助 于 模 
式 划分 。 特 别 是 在 电话 语音 识别 方面 ， 由 于 其 有 着 广泛 的 应 用 前 景 ， 成 了 当前 语音 识别 应 用 的 一 个 

另外 ， 面 向 个 人 用 途 的 连续 语音 听写 机 技术 也 日 趋 完善 。 这 方面 最 具 代 表 性 的 是 IBM 的 ViaVoice 
和 Dragon 公司 的 Dragon Dictate 系统 。 这 些 系 统 具 有 说 话 人 自 适 应 能 力 ， 新 用 户 不 需要 对 全 部 词汇 进 
行 训练 ， 便 可 在 使 用 中 不 断 提高 识别 率 。 
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Г 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 6 ¥\Text-To-Speech 技术 .avi 

Text-To-Speech 简称 TTS， 是 Android 1.6 版 本 中 比较 重要 的 新 功能 ， 能 够 将 所 指定 的 文本 转 成 不 
同 语言 音频 输出 。TTS 可 以 方便 地 嵌入 到 游戏 或 者 应 用 程序 中 ， 增 强 用 户 体验 。 本 节 将 详细 讲解 在 
Android 系统 中 使 用 Text-To-Speech 技术 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


6.2.1 Text-To-Speech 基础 


TTS engine 依托 于 当前 Android Platform 所 支持 的 如 下 5 大 语言 : 
English 

French 

German 

Italian 


ARARA 


Spanish 

TTS 可 以 将 文本 随意 地 转换 成 以 上 任意 5 种 语言 的 语音 输出 。 与 此 同时 ， 对 于 个 别 的 语言 版 本 将 
取决 于 不 同 的 时 区 ,例如 对 于 English, # TTS 中 可 以 分 别 输出 美式 和 英 式 两 种 不 同 的 版 本 。 既 然 能 支 
持 如 此 庞大 的 数据 量 ，TTS 引擎 对 于 资源 的 优化 采取 预 加 载 的 方法 。 根 据 一 系列 的 参数 信息 从 库 中 提 
取 相 应 的 资源 ， 并 加 载 到 当前 系统 中 。 尽 管 当前 大 部 分 加 载 有 Android 操作 系统 的 设备 都 通过 这 套 引 
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擎 来 提供 TTS 功能 ， 但 由 于 一 些 设备 的 存储 空间 非常 有 限 ， 而 影响 到 TTS 最 大 限度 地 发 挥 功 能 ， 算 是 
当前 的 一 个 瓶颈 。 为 此 开发 小 组 引入 了 检测 模块 ， 让 利用 这 项 技术 的 应 用 程序 或 者 游戏 针对 不 同 的 设 
备 可 以 有 相应 的 优化 调整 ， 从 而 避免 由 于 此 项 功能 的 限制 ， 影 响 到 整个 应 用 程序 的 使 用 。 比 较 稳 受 的 
做 法 是 让 用 户 自行 选择 是 否 有 足够 的 空间 或 者 需求 来 加 载 此 项 资源 ,下面 给 出 了 一 个 标准 的 检测 方法 。 

Intent checkintent = new Intent(); 

checkintent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA); 

startActivityForResult(checkIntent, MY DATA CHECK CODE); 

如 果 当 前 系统 允许 创建 一 个 android.speech.tts.TextToSpeech 的 Object 对 象 ， 则 说 明 已 经 提供 TTS 
功能 的 支持 , 将 检测 返回 结果 中 给 出 的 CHECK VOICE DATA PASS тіп. 如 果 系 统 不 支持 这 项 功能 ， 
那么 用 户 可 以 选择 是 否 加 载 这 项 功能 ， 从 而 让 设备 支持 输出 多 国语 言语 音 的 功能 Multi-lingual Talking。 
ACTION INSTALL TTS DATA intent 将 用 户 引 入 Android market 中 的 TTS FRAM. 下载 完 成 后 将 自 
动 完成 安装 ， 实 现 上 述 过 程 的 完整 代码 Candroidres.com) 如 下 : 

private TextToSpeech mTts; 

protected void onActivityResult(int requestCode, int resultCode, Intent data) { 

if (requestCode == MY_DATA_CHECK_CODE) { 

if (resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS) { 
mTts = new TextToSpeech(this, this); 

} езе { 
Intent installintent = new Intent(); 

installlntent.setAction( 
TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA); 

startActivity(installlntent); 


) 
} 
TextToSpeech 实体 和 OnlnitListener 都 需要 引用 当前 Activity 的 Context 作为 构造 参数 。 
OnInitListener() 的 用 处 是 通知 系统 当前 TTS Engine 已 经 加 载 完成 ， 并 处 于 可 用 状态 。 


6.22 Text-To-Speech 的 实现 流程 


(1) 检查 TTS 数据 是 否 可 用 ， 例 如 下 面 的 代码 。 

view plaincopy to clipboardprint? 

/检查 TTS 数据 是 否 已 经 安装 并 且 可 用 
Intent checkintent = new Intent(); 
checkintent.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA); 
startActivityForResult(checkintent, REQ_TTS_STATUS_CHECK); 

protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if(requestCode == REQ_TTS_STATUS_CHECK) 


switch (resultCode) { 

case TextToSpeech.Engine.CHECK_VOICE_DATA_PASS: 
/这 个 返回 结果 表明 TTS Engine 可 以 用 

{ 
mTts = new TextToSpeech(this, this); 
Log.v(TAG, "TTS Engine is installed!"); 


break; 
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case TextToSpeech.Engine.CHECK VOICE DATA BAD DATA: 
/需要 的 语音 数据 已 损坏 

case TextToSpeech.Engine.CHECK VOICE DATA MISSING DATA: 
/缺少 需要 语言 的 语音 数据 

case TextToSpeech.Engine.CHECK_VOICE_DATA_MISSING_VOLUME: 
/缺少 需要 语言 的 发 音 数据 

人 
/这 3 种 情况 都 表明 数据 有 错 ， 重 新 下 载 安装 需要 的 数据 
Log.v(TAG, "Need language stuff:"+resultCode); 
Intent datalntent = new Intent(); 
datalntent.setAction(TextToSpeech.Engine.ACTION INSTALL TTS DATA); 
startActivity(datalntent); 


} 
break; 
case TextToSpeech.Engine.CHECK_VOICE_DATA_FAIL: 
// 检 查 失败 
default: 
Log.v(TAG, "Got a failure. TTS apparently not available"); 
break; 


} 


else 


/其 他 Intent 返回 的 结果 
} 
} 
(2) 初始 化 TTS， 例 如 下 面 的 代码 。 
view plaincopy to clipboardprint? 
/实现 TTS 初始 化 接口 
@Override 
public void onlnit(int status) { 
IITTS Engine 初始 化 完成 
if(status == TextToSpeech.SUCCESS) 


int result = mTts.setLanguage(Locale.US); 

/设置 发 音 语言 

if(result == TextToSpeech.LANG MISSING DATA || result == TextToSpeech.LANG_NOT_ 

SUPPORTED) 

// 判 断 语言 是 否 可 用 
Log.v(TAG, "Language is not available"); 
speakBtn.setEnabled(false); 

} 

else 

{ 

mTts.speak("This is an example of speech synthesis.", TextToSpeech.QUEUE ADD, null); 

speakBtn.setEnabled(true); 

i} 
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(3) 设置 发 音 语言 ， 例 如 下 面 的 代码 。 
view plaincopy to clipboardprint? 
public void onltemSelected(AdapterView<?> parent, View view, 
int position, long id) { 
int pos = langSelect.getSelecteditemPosition(); 


int result = -1; 
switch (pos) { 
case 0: 


inputText.setText("I love you"); 
result = mTts.setLanguage(Locale.US); 


} 
break; 
case 1: 
inputText.setText("Je t'aime"); 
result = mTts.setLanguage(Locale.FRENCH); 
} 
break; 
case 2: 
inputText.setText("Ich liebe dich"); 
result = mTts.setLanguage(Locale.GERMAN); 
} 
break; 
case 3: 
inputText.setText("Ti amo"); 
result = mTts.setLanguage(Locale.ITALIAN); 
} 
break; 
case 4: 
{ 
inputText.setText("Te quiero"); 
result = mTts.setLanguage(new Locale("spa", "ESP")); 
n 
break; 
default: 
break; 
} 
/设置 发 音 语 言 
if(result == TextToSpeech.LANG MISSING DATA || result == TextToSpeech.LANG_NOT_SUPPORTED) 
// 判 断 语言 是 否 可 用 
{ 
Log.v(TAG, "Language is not available"); 
speakBtn.setEnabled(false); 
} 
else 
{ 
speakBtn.setEnabled(true); 
} 
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(4) 设置 单 击 Button 按钮 发 出 声音 ， 例 如 下 面 的 代码 。 
view plaincopy to clipboardprint? 
public void onClick(View v) { 
/朗读 输入 框 中 的 内 容 
mTts.speak(inputText.getText().toString(), TextToSpeech.QUEUE_ADD, null); 
} 


6.2.3 ”实战 演练 一 一 使 用 Text-To-Speech 实现 语音 识别 


下 面 将 通过 一 个 具体 实例 的 实现 过 程 , 详细 讲解 在 Android 物 联网 设备 中 使 用 Text-To-Speech 技术 
实现 语音 识别 的 过 程 。 本 实例 的 功能 是 在 屏幕 中 显示 一 个 文本 框 供用 户 输 入 需要 读 的 内 容 ， 单 击 按钮 
后 开始 读 取 文本 框 中 输入 的 内 容 ， 本 实例 支持 中 文 。 


СТ) 编写 布局 文件 main.xml, 功能 是 在 屏幕 中 显示 一 个 可 输入 内 容 的 文本 框 , 具体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientationz"vertical" android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
«EditText android:id="@+id/EditText01" android:text="hello диап" 
android:layout widthz"fill parent" android:layout height-"wrap content" 
</EditText> 
«Button android:text=" 朗 读 " android:id="@+id/Button01" 
android:layout_width="wrap_content" android:layout_height="wrap_content"> 
</Button> 
</LinearLayout> 
(2) 编写 程序 文件 speechActivityjava， 功 能 是 根据 用 户 在 文本 框 中 输入 的 内 容 实现 语音 识别 ， 具 
体 实现 代码 如 下 : 
public class speechActivity extends Activity implements TextToSpeech.OnlnitListener( 
private TextToSpeech mSpeech; 
private Button btn; 
static final int TTS_CHECK_CODE = 0; 
private EditText mEditText; 
private TTS myTts; 


@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
btn = (Button) findViewByld(R.id.Button01); 
mEditText = (EditText) findViewByld(R.id.EditTextO1); 
//btn.setEnabled(false); 
myTts = new TTS(this, ttsInitListener, true); 
mSpeech = new TextToSpeech(this, this); 
btn.setOnClickListener(new OnClickListener() { 
public void onClick(View v) { 
myTts.setLanguage("CHINESE"); 
myTts.speak(mEditText.getText().toString(), 0, null); 
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mSpeech.speak(mEditText.getText().toString(), 
TextToSpeech.QUEUE_FLUSH, null); 


D 
) 


private TTS.InitListener ttsInitListener = new TTS.InitListener() { 
public void onlnit(int version) { 
myTts.setLanguage(" CHINESE"); 
myTts.speak("##", 0, null); 
} 


public void onlnit(int status) { 
if (status == TextToSpeech.SUCCESS) { 
int result = mSpeech.setLanguage(Locale.CHINA); 
if (result == TextToSpeech.LANG_MISSING_DATA 
|| result == TextToSpeech.LANG NOT. SUPPORTED) { 


Log.e("lanageTag", "not use"); 


) else { 
btn.setEnabled(true); 
mSpeech.speak(" 我 喜欢 你 ", TextToSpeech.QUEUE_FLUSH, 
null); 
} 
} 
} 
@Override 


protected void onDestroy() { 
if (mSpeech != null) { 
mSpeech.stop(); 
mSpeech.shutdown(); 
} 
super.onDestroy(); 
} 
} 
执行 后 的 效果 如 图 6-1 所 示 。 


图 6-1 执行 效果 


624 ”实战 演练 一 一 借助 开源 项 目 实现 中 文 语 音 识别 


Android 从 1.6 版 本 开始 便 支 持 Text To Speech, 使 用 的 是 Pico 语音 合成 引擎 , 但 是 只 支持 English. 
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French, German, Italian 和 Spanish 5 大 语言 , 暂时 没有 对 中 文 提供 支持 。 因 此 使 用 Android 默认 的 TTS 
Engine 是 无 法 朗读 中 文 的 。 读 者 可 以 通过 开源 项 目 eyes-free (http://code.google.com/p/eyes-free/) 来 实 
现 。 在 安装 开源 项 目 eyes-free 提供 的 TTS Service Extended 的 APK 后 ， 就 可 以 在 程序 中 使 用 开源 项 目 
eyes-free 提供 的 TTS library， 并 把 TTS Engine 设置 为 不 是 默认 的 Pico， 而 是 eSpeak， 这 样 就 可 以 实现 
朗读 中 文 功能 。 


下 面 将 通过 一 个 具体 实例 的 实现 过 程 , 详细 讲解 在 Android 物 联 网 设备 中 使 用 Text-To-Speech 技术 
识别 中 文 语音 的 过 程 。 


(1) 从 网 络 中 下 载 需要 的 开源 TTS library 的 jar 包 ， 然 后 新 建 一 个 Android 工程 ， 工 程 名 为 ТТ5СН, 
并 且 把 下 载 的 jar 包 放 在 assets 文件 夹 下 。 右 击 工程 ， 在 弹出 的 快捷 菜单 中 选择 properties | Java Build 
Path | Libraries | Add JARs 命令 ， 然 后 向 工程 中 添加 进 assets 下 的 jar 包 。 工 程 结 构 如 图 6-2 所 示 。 


8-09 sre 
申 国 gen [Generated Java Files] 
BA Google APIs [Android 2.2] 
E) BA Referenced Libraries 
Ф TIS library stub 3.0 market. j 
Ë BÀ Android Dependencies 
Ge assets 
А] TIS library stub 3.0 market. j 
& E» bin 
由 世 res 
J| Androidilani fest. xml 
В project. properties 


图 6-2 工程 结构 


(2) 编写 布局 文件 main.xml， 功 能 是 在 屏幕 中 显示 一 个 可 输入 内 容 的 文本 框 ， 并 在 下 方 显示 一 个 
触发 识别 功能 的 单 击 按钮 。 文 件 main.xml 的 具体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
> 
<EditText 
android:id="@+id/ttstext" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text=" 可 以 说 中 文 "> 
</EditText> 
<Button 
android:id="@+id/ttsbtn" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" 开 始 说 " 
android:enabled="false"> 
</Button> 
</LinearLayout> 
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(3) 编写 Java 程序 文件 ， 使 用 开源 项 目 eyes-free 的 TTS API 中 的 TextToSpeechBeta 创 寻 


具体 实现 代码 如 下 : 
public class NiHaoTTS extends Activity implements OnlnitListener( 
/** Called when the activity is first created. */ 
private Button mBtn; 
private EditText mText; 
/使 用 com.google.tts 包 中 的 TextToSpeechBeta 
private TextToSpeechBeta mTTS; 


private static final String TAG = "TTS Demo"; 
private static final int REQ TTS STATUS CHECK = 0; 


@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


IRRE TTS 数据 是 否 已 经 安装 并 且 可 用 

Intent checklntent = new Intent(); 
checkintent.setAction(TextToSpeechBeta.Engine. ACTION_CHECK_TTS_DATA); 
startActivityForResult(checkIntent, REQ TTS STATUS CHECK); 


mText = (EditText)findViewByld(R.id.ttstext); 
mBtn = (Button) findViewByld(R.id.ttsbtn); 
mBtn.setOnClickListener(new OnClickListener() { 


@Override 
public void onClick(View v) { 
String ttsText = mText.getText().toString(); 


if(ttsText Iz "") 
// 读 取 文 本 框 中 的 中 文 
mTTS.speak(ttsText, TextToSpeechBeta.QUEUE ADD, null); 
} 
} 
; }; 
/实现 TTS 初始 化 接口 
@Override 


public void oninit(int status, int version) { 
Log.v(TAG, "version = " + String.valueOf(version)); 
// 判 断 TTS 初始 化 的 返回 版 本 号 ， 如 果 为 -1， 表 示 没 有 安装 对 应 的 TTS 数据 
if(version == -1) 


// 提 示 安 装 所 需 的 TTS 数据 
alertinstallEyesFreeTTSData(); 
1 
else 


IITTS Engine 初始 化 完成 
if(status == TextToSpeechBeta.SUCCESS) 
{ 


Ë TTS 对 
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Log.v(TAG, "success to init tts"); 
/设置 TTS 8|&, com.google.tts Bl eSpeak 支持 的 语言 包含 中 文 ， 使 用 Android 系统 默认 
的 pico 可 以 设置 为 com.svox.pico 
mTTS.setEngineByPackageNameExtended("com.google.tts"); 
int result = mTTS.setLanguage(Locale.CHINA); 
/设置 发 音 语言 
if(result == TextToSpeechBeta.LANG MISSING DATA || result == TextToSpeechBeta. 
LANG NOT. SUPPORTED) 
// 判 断 语言 是 否 可 用 
Log.v(TAG, "Language is not available"); 
mBtn.setEnabled(false); 


else 

{ 
mTTS.speak(" 你 好 ,朋友 !", TextToSpeechBeta.QUEUE_ADD, null); 
mBtn.setEnabled(true); 


) 


else 


Log.v(TAG, "failed to init tts"); 


) 


protected void onActivityResult(int requestCode, int resultCode, Intent data) ( 
if(requestCode == REQ_TTS_STATUS_CHECk) 
{ 
switch (resultCode) { 
case TextToSpeechBeta.Engine.CHECK VOICE DATA PASS: 
// 这 个 返回 结果 表明 TTS Engine 可 以 用 


/使 用 的 是 TextToSpeechBeta 
mTTS = new TextToSpeechBeta(this, this); 
Log.v(TAG, "TTS Engine is installed!"); 


break; 

case TextToSpeechBeta.Engine.CHECK_VOICE_DATA_BAD_DATA: 
/需要 的 语音 数据 已 损坏 

case TextToSpeechBeta.Engine.CHECK_VOICE_DATA_MISSING_DATA: 
// 缺 少 需要 语言 的 语音 数据 

case TextToSpeechBeta.Engine.CHECK VOICE DATA MISSING VOLUME: 
// 缺 少 需要 语言 的 发 音 数据 

{ 
// 这 З 种 情况 都 表明 数据 有 错 ， 重 新 下 载 安 装 需要 的 数据 
Log.v(TAG, "Need language stuff:"+resultCode); 
Intent datalntent = new Intent(); 
datalntent.setAction(TextToSpeechBeta.Engine.ACTION INSTALL TTS DATA); 
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startActivity(datalntent); 
} 
break; 
case TextToSpeechBeta.Engine.CHECK VOICE DATA FAIL: 
/检查 失败 
default: 
Log.v(TAG, "Got a failure. TTS apparently not available"); 
break; 
} 
} 
else 
// 其 他 Intent 返回 的 结果 


} 
// 弹 出 对 话 框 提示 安装 所 需 的 TTS 数据 
private void alertlnstallEyesFreeTTSData() 


Builder alertinstall = new AlertDialog.Builder(this) 
.SetTitle(" 缺 少 需要 的 语音 包 ") 
.SetMessage(" 下 载 安装 缺少 的 语音 包 ") 

.SetPositiveButton(" 确 定 ", new DialogInterface.OnClickListener() { 


@Override 
public void onClick(DialogInterface dialog, int which) { 
/下 载 eyes-free 的 语音 数据 包 
String ttsDataUrl = "http://eyes-free.googlecode.com/files/tts_3.1_market.apk"; 
Uri ttsDataUri = Uri.parse(ttsDataUrl); 
Intent ttsIntent = new Intent(Intent ACTION_VIEW, ttsDataUri); 


startActivity(ttsIntent); 
) 
» 
.setNegativeButton(" B", new DialogInterface.OnClickListener() ( 
@Override 
public void onClick(Dialoginterface dialog, int which) { 
finish(); 
} 
D: 
alertinstall.create().show(); 
} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
if(mTTS!=null){ 
mTTS.shutdown(); 
} 
} 
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@Override 
protected void onPause() { 
super.onPause(); 
if(mTTS != null) 
{ 
mTTS.stop(); 
} 
} 


} 

执行 后 将 先 提 示 安 装 APK 安装 包 ， 如 图 6-3 所 示 。 

安装 完成 后 会 在 应 用 程序 中 看 到 对 应 的 图 标 ， 并 且 在 TTS 的 设置 中 也 会 增加 eSpeak TTS 项 ， 如 
图 6-4 所 示 。 


图 6-3 ”提示 安装 APK 包 图 6-4 成 功 安装 效果 
安装 后 再 次 打开 应 用 程序 ， 这 时 会 有 个 选择 询问 使 用 哪个 TTS， 选 择 第 二 项 ， 如 图 6-5 所 示 。 此 
时 就 可 以 在 文本 框 中 输入 中 文 来 识别 了 。 


© Complete action using 


j| Pico TTS 


=) TIS Service Extended 


[mem 


图 6-5 询问 界面 


6.3 Voice Recognition 技术 详解 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 6 章 \Voice Recognition 技术 详解 .avi 
RANÉ, RHI iPhone 语音 识别 用 的 是 Google 的 技术 ， 作 为 力 推 Android 的 Google 自然 会 将 


DO Android oe ae AC [1813 


其 核心 技术 植 入 其 中 ,并 结合 Google 的 云端 技术 将 其 发 扬 光 大 。 本 节 将 详细 讲解 Voice Recognition 1% 


术 的 基本 知识 。 


6.3 


.1 Voice Recognition 技术 基础 


TE Android 中 使 用 Google 的 Voice Recognition 的 方法 极其 简单 ， 在 Android 自 带 的 API 例子 中 ， 


是 通过 一 个 Intent 的 Action 动作 来 完成 的 ， 主 要 有 以 下 两 种 模式 。 
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ACTION RECOGNIZE SPEECH: 一 般 语 音 识别 ， 在 这 种 模式 下 可 以 捕捉 到 语音 处 理 后 的 文 


字 列 。 
М ACTION WEB SEARCH: 网 络 搜索 。 
在 API Demo 源码 中 提供 的 语音 识别 实例 的 具体 实现 代码 如 下 : 
package com.example.android.apis.app; 


import com.example.android.apis.R; 


import android.app.Activity; 

import android.content.Intent; 

import android.content.pm.PackageManager; 
import android.content.pm.Resolvelnfo; 
import android.os.Bundle; 

import android.speech.Recognizerlntent; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.ArrayAdapter; 
import android.widget.Button; 

import android.widget.ListView; 


import java.util.ArrayList; 
import java.util.List; 


p 
* 用 API 开发 的 抽象 语音 识别 代码 
di 

public class VoiceRecognition extends Activity implements OnClickListener { 


private static final int VOICE RECOGNITION REQUEST CODE - 1234; 
private ListView mList; 


p 
* 呼 叫 与 活动 首先 被 创建 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
/从 它 的 XML 布局 描述 的 U! 
setContentView(R.layout.voice recognition); 
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// 得 到 最 新 互 作 用 的 显示 项 目 
Button speakButton = (Button) findViewByld(R.id.btn_speak); 
mList = (ListView) findViewByld(R.id_list); 


// 查 看 公认 活动 是 否 存在 
PackageManager pm = getPackageManager(); 
List<Resolvelnfo> activities = pm.queryintentActivities( 
new Intent(Recognizerintent ACTION. RECOGNIZE SPEECH), 0); 

if (activities.size() != 0) ( 

speakButton.setOnClickListener(this); 
) else ( 

speakButton.setEnabled(false); 

speakButton.setText("Recognizer not present"); 


} 


p 
* 单 击 “开始 识别 ”按钮 后 的 处 理事 件 
s 
public void onClick(View v) { 
if (v.getld() == R.id.btn_speak) { 
startVoiceRecognitionActivity(); 
} 
} 
p 
* 发 送 开始 语音 识别 信号 
E 
private void startVoiceRecognitionActivity() ( 
Intent intent = new Intent(Recognizerintent ACTION RECOGNIZE SPEECH); 
intent.putExtra(Recognizerlntent.EXTRA LANGUAGE MODEL, 
RecognizerIntent.LANGUAGE MODEL FREE FORM); 
intent.putExtra(Recognizerlntent.EXTRA PROMPT, "Speech recognition demo"); 
startActivityForResult(intent, VOICE RECOGNITION REQUEST. CODE); 
} 


p 
“处 理 识别 结果 
* 
jl 
@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (requestCode == VOICE RECOGNITION REQUEST. CODE && resultCode == RESULT. OK) { 


ArrayList<String> matches = data.getStringArrayListExtra( 
Recognizerlntent. EXTRA. RESULTS); 

mList.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple list item 1, 
matches)); 


} 
super.onActivityResult(requestCode, resultCode, data); 
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上 述 代码 保存 在 Google 的 АРІ 开源 文件 中 ， 原 理 和 实现 代码 十 分 简单 ， 感 兴趣 的 读者 可 以 学 习 一 
下 ， 上 述 源码 执行 后 ， 用 户 通过 单 击 Speak! 按 钮 ， 显 示 界 面 如 图 6-6 所 示 ; 用 户 说 完 话 后 将 提交 到 云 
端 搜索 ， 如 图 6-7 所 示 ; 在 云端 搜索 完成 后 将 返回 打印 数据 ， 如 图 6-8 所 示 。 


请 开始 说 话 


”, 
ШАГУ 


‘Speech recognition demo 


图 6-6 单 击 按钮 后 图 6-7 说 完 后 图 6-8 返回 识别 结果 


6.3.2 ”实战 演练 一 一 使 用 Voice Recognition 实现 语音 识别 


本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲 解 在 Android 物 联网 设备 中 使 用 Voice Recognition 
技术 实现 语音 识别 的 过 程 。 


本 实例 的 功能 是 在 屏幕 中 显示 一 个 文本 框 供用 户 输入 需要 读 的 内 容 ， 单 击 按钮 后 开始 读 取 文 本 框 
中 输入 的 内 容 ， 本 实例 支持 中 文 。 本 实例 的 具体 实现 流程 如 下 : 
СТ) 编写 布局 文件 activity_main.xml， 功 能 是 在 屏幕 中 设置 一 个 图 标 按钮 ， 单 击 按钮 后 可 以 说 话 ， 
并 在 下 方 列 表 中 显示 语音 识别 结果 。 文 件 activity_main.xml 的 具体 实现 代码 如 下 : 
<LinearLayout xmIns:android-"http://schemas.android.com/apk/res/android" 
xmins:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:paddingBottom-"(gdimen/activity vertical margin" 
android:paddingLeft-"(dimen/activity horizontal margin" 
android:paddingRight-"(Qdimen/activity horizontal margin" 
android:paddingTop-"(gdimen/activity vertical margin" 
tools:context=".MainActivity" > 


<TextView 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:layout margin-"20dp" 
android:text-"(gstring/start voice" 
android:textSize="16sp" /> 


<Button 


android:id="@+id/mic_button" 
android:layout width-"wrap content" 
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android:layout height-"wrap content" 
android:layout gravity-"center horizontal" 
android:background="@drawable/ic_mic" /> 


<ListView 
android:id="@+id/result_list" 
android:layout width-"fill parent" 
android:layout height-"Odip" 
android:layout_weight="1" /> 


</LinearLayout> 
(2) 编写 主 Activity 文件 MainActivityjava， 功 能 是 监听 用 户 单 击 屏幕 的 图 标 按钮 ， 调 用 识别 函数 
进行 语音 识别 ， 并 调用 函数 onActivityResult 显示 识别 结果 。 文 件 MainActivityjava 的 具体 实现 代码 
如 下 : 
public class MainActivity extends Activity { 


private static final int REQUEST_CODE = 1; 
private ListView mResultList; 
private Button mMicButton; 


@Override 

protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity main); 


mMicButton = (Button) findViewByld(R.id.mic button); 
mResultList = (ListView) findViewBylId(R.id.result list); 


PackageManager pm = getPackageManager(); 
List<Resolvelnfo> activities = pm.queryintentActivities(new Intent(Recognizerintent ACTION_RECOGNIZE_ 
SPEECH), 0); 
if (activities == null || activities.size() == 0) { 
mMicButton.setEnabled(false); 
Toast.makeText(getApplicationContext(), "Not Supported", Toast.LENGTH_LONG).show(); 
) 
mMicButton.setOnClickListener(new OnClickListener() ( 
@Override 
public void onClick(View v) { 
runVoiceRecognition(); 
} 
}; 
} 


private void runVoiceRecognition() { 
Intent intent  VoiceRecognitionIntentFactory.getFreeFormRecognizelntent("Speak Now..."); 
startActivityForResult(intent, REQUEST_CODE); 

} 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
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if (requestCode == REQUEST. CODE && resultCode == RESULT_OK) { 
ArrayList<String> matches = data.getStringArrayListExtra(Recognizerlntent. EXTRA RESULTS); 
mResultList.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, 

matches)); 


} 


super.onActivityResult(requestCode, resultCode, data); 


} 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.voice, menu); 
return true; 


} 
(3) 编写 文件 VoiceRecognitionIntentFactoryjava， 功 能 是 调用 Android 内 置 的 Voice Recognition 
技术 实现 语音 识别 功能 ， 有 具体 实现 代码 如 下 : 
public class VoiceRecognitionIntentFactory { 
public static final int ACTION_GET_LANGUAGE_DETAILS_REQUEST_CODE = 88811; 
private static final int MAX_RESULTS = 100; 


private VoiceRecognitionIntentFactory() { } 
public static Intent getSimpleRecognizerlntent(String prompt) 


Intent intent = getBlankRecognizelntent(); 
intent.putExtra(Recognizerlntent.EXTRA LANGUAGE MODEL, 

RecognizerIntent. LANGUAGE MODEL WEB SEARCH); 
intent.putExtra(RecognizerIntent. EXTRA PROMPT, prompt); 
return intent; 


} 
public static Intent getBlankRecognizelntent() 


Intent intent = new Intent(RecognizerIntent. ACTION RECOGNIZE SPEECH); 
return intent; 
) 


public static Intent getFreeFormRecognizeintent(String prompt)( 
Intent intent = getBlankRecognizelntent(); 
intent.putExtra(Recognizerlntent.EXTRA LANGUAGE MODEL, 
RecognizerIntent LANGUAGE, MODEL, FREE, FORM); 
intent.putExtra(RecognizerIntent.EXTRA PROMPT, prompt); 
return intent; 


} 


public static Intent getWebSearchRecognizelntent() 


{ 
Intent intent = new Intent(RecognizerIntent. ACTION WEB SEARCH); 
return intent; 
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} 
public static Intent getHandsFreeRecognizelntent() 


Intent intent = new Intent(Recognizerlntent. ACTION_VOICE_SEARCH_HANDS_ FREE); 
return intent; 


} 


public static Intent getPossilbeWebSearchRecognizelntent(String prompt) 

{ 
Intent intent = getWebSearchRecognizelntent(); 
intent.putExtra(Recognizerlntent.EXTRA LANGUAGE MODEL, 

RecognizerIntent.LANGUAGE MODEL WEB SEARCH); 

intent.putExtra(Recognizerlntent.EXTRA PROMPT, prompt); 
intent.putExtra(Recognizerlntent.EXTRA MAX RESULTS, MAX RESULTS); 
intent.putExtra(RecognizerIntent.EXTRA WEB SEARCH ONLY, false); 
intent.putExtra(Recognizerlntent.EXTRA PARTIAL RESULTS, true); 


return intent; 
) 
public static Intent getLanguageDetailsIntent() 
( 
Intent intent = new Intent(Recognizerlntent.ACTION GET LANGUAGE DETAILS); 
return intent; 
} 
} 
至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 6-9 所 示 。 
R ü 
(WoiceRecognivon 00. 
Click the button below and start 
speaking 
9 
Y 
图 6-9 执行 效果 
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CA 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 6 章 \ 为 设备 中 所 有 的 APP 实现 语音 提醒 功能 .avi 

在 Android 设备 应 用 中 ， 通 常 使 用 提醒 功能 来 及 时 通知 当前 的 状态 信息 ， 例 如 来 短信 时 会 在 顶部 
状态 栏 中 显示 提示 文字 。 本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 详 细 讲 解 将 提醒 文字 转换 为 语音 的 方 
法 ， 通 过 声音 来 实现 状态 提醒 功能 。 本 实例 的 功能 十 分 强大 ， 能 够 为 当前 设备 中 所 有 已 经 安装 的 APP 
程序 实现 语音 提醒 功能 。 
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本 实例 是 一 个 开源 的 Android 应 用 程序 ， 使 用 文本 在 Android 1.6 及 以 上 设备 的 状态 栏 中 发 送 文本 
通知 消息 时 ， 实 现 辅助 服务 的 语音 通知 功能 ， 这 样 可 以 在 不 看 屏幕 的 情况 下 也 能 及 时 获取 通知 信息 的 
内 容 。 在 本 实例 的 语音 功能 列表 中 ， 可 以 设置 语音 提醒 功能 的 各 个 属性 。 

(1) 编写 布局 文件 appwidgetxml， 功 能 是 在 屏幕 中 显示 一 个 指定 的 图 片 作为 背景 ， 具 体 实现 代码 
如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

«ImageButton xmins:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/button" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:background="@null" 
android:scaleType="fitCenter” 
android:src="@drawable/widget_disabled"/> 

(2) 编写 文件 WidgetProviderjava， 功 能 是 通过 布局 文件 appwidget.xml 载 入 预制 的 部 件 ， 实 现 界 
面 视图 功能 。 文 件 WidgetProviderjava 的 具体 实现 代码 如 下 : 

public class WidgetProvider extends AppWidgetProvider { 

static final String ACTION TOGGLE = "voicenotify.widget. TOGGLE", 
ACTION UPDATE = "voicenotify. widget. UPDATE"; 


@Override 
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetlds) { 
for (int i = 0; i < appWidgetlds.length; i++) ( 
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget); 
updateViews(context, views); 
appWidgetManager.updateAppWidget(appWidgetlds[i], views); 


) 


@Override 
public void onReceive(Context context, Intent intent) { 
if (intent.getAction().equals(ACTION_TOGGLE)) { 
if (Service.isRunning()) { 
Toast.makeText(context, 
Service.toggleSuspend() ? R.string.service suspended : R.string.service running, 
Toast.LENGTH_SHORT).show(); 
} 
} else if (intent.getAction().equals(ACTION_UPDATE)) { 
RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.appwidget); 
updateViews(context, views); 
AppWidgetManager.getinstance(context).updateAppWidget(new ComponentName(context, 
WidgetProvider.class), views); 
} else super.onReceive(context, intent); 


} 


private static void updateViews(Context context, RemoteViews views) { 
PendingIntent pendingIntent; 
if (Service.isRunning()) { 
pendingintent = PendingIntent.getBroadcast(context, 0, 
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new Intent(context, WidgetProvider.class).setAction(ACTION_TOGGLE), 0); 
if (Service.isSuspended()) { 
views.setlmageViewResource(R.id.button, R.drawable.widget suspended); 
}else { 
views.setlmageViewResource(R.id.button, R.drawable.widget running); 
) 
}else { 
pendingintent = Pendingintent.getActivity(context, 0, MainActivity.getAccessibilityIntent(), 0); 
views.setlmageViewResource(R.id.button, R.drawable.widget disabled); 
} 
views.setOnClickPendingIntent(R.id.button, pendingIntent); 
} 
} 


执行 效果 如 图 6-10 所 示 。 


图 6-10 ”执行 效果 


(3) 编写 文件 preferences.xml， 功 能 是 列表 显示 本 语音 识别 系统 的 设置 选项 ， 例 如 TTS 设置 选项 、 
TTS 流 和 TTS 延 时 等 选项 。 文 件 preferences.xml 的 具体 实现 代码 如 下 : 
<PreferenceScreen xmins:android="http://schemas.android.com/apk/res/android"> 

<Preference 
android:key="@string/key_status" /> 

<Preference 
android:key="@string/key_appList" 
android:title="@string/app_list" 
android:summary="@string/app_list_summary" /> 

<Preference 
android:key="@string/key_ttsSettings" 
android:title="@string/tts_settings" 
android:summary="@string/tts_settings_summary" /> 

<EditTextPreference 
android:key="@string/key_ttsString" 
android:title="@string/tts_message" 
android:summary="@string/tts_message_summary" 
android:dialogMessage="@string/tts_message_dialog" 
android:defaultValue="%t: %m" /> 

<ListPreference 
android:key="@string/key_ttsStream" 
android:title="@string/tts_stream" 
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android:summary="@string/tts_stream_summary" 
android:entries="@array/stream_name" 
android:entryValues="@array/stream_value" 
android:defaultValue="3" /> 

<EditTextPreference 
android:key="@string/key_ttsDelay" 
android:title="@string/tts_delay" 
android:summary="@string/tts_delay_summary" 
android:dialogMessage="@string/tts_delay_dialog_msg" 
android:digits="0123456789" 
android:inputType="number" /> 

<EditTextPreference 
android:key="@string/key_tts_repeat" 
android:title="@string/tts_repeat" 
android:summary="@string/tts_repeat_summary" 
android:dialogMessage="@string/tts_repeat_dialog_msg" 
android:digits="0123456789" 
android:inputType="number" /> 

<CheckBoxPreference 
android:key="@string/key_toasts" 
android:title="@string/speak_toasts" 
android:summary="@string/speak_toasts_summary" /> 

<CheckBoxPreference 
android:key="@string/key_audio_focus" 
android:title="@string/audio_focus" 
android:summary="@string/audio_focus_summary" 
android:defaultValue="true" /> 

<EditTextPreference 
android:key="@string/key_shake_threshold" 
android:title="@string/shake_to_silence" 
android:summary="@string/shake_to_silence_summary" 
android:dialogMessage="@string/shake_to_silence_dialog_msg" 
android:digits="0123456789" 
android:inputType="number" 
android:defaultValue="100" /> 

<EditTextPreference 
android:key="@string/key_ignore_strings" 
android:title="@string/ignore_strings" 
android:summary="@string/ignore_strings_summary" 
android:dialogMessage="@string/ignore_strings_dialog_msg" /> 

<CheckBoxPreference 
android:key="@string/key_ignore_empty" 
android:title="@string/ignore_empty" 
android:summaryOn="@string/ignore_empty_summary_on" 
android:summaryOff="@string/ignore_empty_summary_off" 
android:defaultValue-"true" /> 

<EditTextPreference 
android:key="@string/key_ignore_repeat" 
android:title="@string/ignore_repeat" 
android:summary="@string/ignore_repeat_summary" 
android:dialogMessage="@string/ignore_repeat_dialog_msg" 
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android:digits="0123456789" 
android:inputType-"number" 
android:defaultValue-"10" /> 
«Preference 
android:key-"(gstring/key device state" 
android:title="@string/device_state” 
android:summary="@string/device_state_summary" /> 
<Preference 
android:key="@string/key_quietStart" 
android:title="@string/quiet_start" 
android:summary="@string/quiet_start_summary" /> 
<Preference 
android:key="@string/key_quietEnd" 
android:title="@string/quiet_end" 
android:summary="@string/quiet_end_summary" /> 
<Preference 
android:key="@string/key_test" 
android:title="@string/test" 
android:summary="@string/test_summary" /> 
<Preference 
android:key="@string/key_notify_log" 
android:title="@string/notify_log" 
android:summary="@string/notify_log_summary" /> 
<Preference 
android:key="@string/key_support" 
android:title="@string/support" 
android:summary="@string/support_summary" /> 
</PreferenceScreen> 
(4) 编写 文件 MainActivityjava， 功 能 是 载 入 文件 preferences.xml 中 的 控件 元 素 实现 界面 布局 ， 
加 载 系统 中 各 个 设置 选项 的 当前 设置 值 。 文 件 MainActivityjava 的 具体 实现 代码 如 下 : 
public class MainActivity extends PreferenceActivity implements OnPreferenceClickListener, 
OnSharedPreferenceChangeListener { 
private static final int SDK VERSION = Build. VERSION.SDK INT; 
private Preference pStatus, pDeviceState, pQuietStart, pQuietEnd, pTest, pNotifyLog, pSupport; 
private static final int DLG DEVICE STATE - 0, 
DLG QUIET START = 1, 
DLG QUIET END = 2, 
DLG LOG - 3, 
DLG SUPPORT - 4, 
DLG DONATE = 5; 
private OnStatusChangeListener statusListener = new OnStatusChangeListener() { 


@Override 
public void onStatusChanged() { 
updateStatus(); 
Hj 
Е 
@Override 


protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
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Common.init(this); 
addPreferencesFromResource(R.xml.preferences); 
pStatus = findPreference(getString(R.string.key_status)); 
pStatus.setOnPreferenceClickListener(this); 
pDeviceState = findPreference(getString(R.string.key_device_state)); 
pDeviceState.setOnPreferenceClickListener(this); 
pQuietStart = findPreference(getString(R.string.key quietStart)); 
pQuietStart.setOnPreferenceClickListener(this); 
pQuietEnd = findPreference(getString(R.string.key_quietEnd)); 
pQuietEnd.setOnPreferenceClickListener(this); 
pTest = findPreference(getString(R.string.key_test)); 
pTest.setOnPreferenceClickListener(this); 
pNotifyLog = findPreference(getString(R.string.key_notify_log)); 
pNotifyLog.setOnPreferenceClickListener(this); 
pSupport = findPreference(getString(R.string.key_support)); 
pSupport.setOnPreferenceClickListener(this); 
findPreference(getString(R.string.key appList)).setIntent(new Intent(this, AppList.class)); 
Preference pTTS = findPreference(getString(R.string.key ttsSettings)); 
Intent ttsIntent = getTtsintent(); 
if (ttsIntent != null) ( 
pTTS.setintent(ttsIntent); 
) else { 
pTTS.setEnabled(false); 
pTTS.setSummary(R.string.tts settings summary fail); 


) 

if (SDK VERSION < 11) { 
getPreferenceScreen().removePreference(findPreference(getString(R.string.key_toasts))); 
if (SDK_VERSION < 8) { 


getPreferenceScreen().removePreference(findPreference(getString(R.string.key_audio_focus))); 


} 
} 


static Intent getAccessibilityIntent() { 

Intent intent new Intent(); 

if (SDK VERSION » 4)( 
intent.setAction(android.provider.Settings.ACTION ACCESSIBILITY SETTINGS); 

} else if (SDK VERSION == 4) { 
intent.setAction(Intent. ACTION MAIN); 
intent.setClassName("com.android.settings", "com.android.settings.AccessibilitySettings"); 

} 

return intent; 


} 


private Intent getTtsIntent() { 
Intent intent = new Intent(Intent ACTION_MAIN); 
if (isClassExist("com.android.settings. TextToSpeechSettings")) { 
if (SDK_VERSION >= 11 && SDK VERSION <= 13) { 
intent.setAction(android.provider.Settings. ACTION_SETTINGS); 
intent.putExtra(EXTRA_SHOW_FRAGMENT, 
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"com.android.settings. TextToSpeechSettings"); 
intent.putExtra(EXTRA SHOW FRAGMENT ARGUMENTS, intent.getExtras()); 
} else intent.setClassName("com.android.settings", "com.android.settings.TextToSpeech Settings"); 
} else if (isClassExist("com.android.settings.Settings$ TextToSpeechSettingsActivity")) ( 
if(SDK VERSION == 14)( 
intent.setAction(android.provider.Settings. ACTION SETTINGS); 
intent.putExtra(EXTRA. SHOW. FRAGMENT, 
"com.android.settings.tts. Text ToSpeechSettings"); 
intent.putExtra(EXTRA SHOW FRAGMENT ARGUMENTS, intent.getExtras()); 
) else intent.setClassName("com.android.settings", "com.android.settings.Settings$TextToSpeech 
SettingsActivity"); 
} else if (isClassExist("com.google.tv.settings. TextToSpeechSettingsTop")) ( 
intent.setClassName("com.google.tv.settings", 
"com.google.tv.settings. Text ToSpeechSettingsTop"); 
) else return null; 
return intent; 


) 


private boolean isClassExist(String name) ( 
try ( 
Packagelnfo pkgInfo = getPackageManager().getPackagelnfo( 
name.substring(0, name.lastindexOf(".")), PackageManager.GET ACTIVITIES); 
if (pkgInfo.activities != null) { 
for (int n = 0; n < pkglnfo.activities.length; n++) { 
if (pkgInfo.activities[n].name.equals(name)) return true; 


) 
) catch (PackageManager.NameNotFoundException e) () 
return false; 
} 
@Override 


public boolean onPreferenceClick(Preference preference) { 
if (preference == pStatus && Service.isRunning() && Service.isSuspended()) { 
Service.toggleSuspend(); 
return true; 
} else if (preference == pDeviceState) { 
showDialog(DLG_DEVICE_STATE); 
return true; 
} else if (preference == pQuietStart) { 
showDialog(DLG_QUIET_START); 
return true; 
} else if (preference == pQuietEnd) { 
showDialog(DLG_QUIET_END); 
return true; 
} else if (preference == pTest) { 
if (‘AppList.findOrAddApp(getPackageName(), this).getEnabled()) ( 
Toast.makeText(this, getString(R.string.test_ignored), Toast.LENGTH_LONG).show(); 
| 
new Timer().schedule(new TimerTask() { 
@Override 
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public void run() { 
Notification notification = new Notification(R.drawable.icon, 
getString(R.string.test_notify_msg), System.currentTimeMillis()); 
notification.defaults |= Notification.DEFAULT_SOUND; 
notification.flags |= Notification.FLAG_AUTO_CANCEL; 
notification.setLatestEventinfo(MainActivity.this, getString(R.string.app name), getString 
(R.string.test), 
PendingIntent.getActivity(MainActivity.this, 0, getIntent(), 0)); 


((NotificationManager)getSystemService(Context.NOTIFICATION_SERVICE)).notify(0, notification); 


} 

}, 5000); 
return true; 

} else if (preference == pNotifyLog) { 
showDialog(DLG_LOG); 
return true; 

} else if (preference == pSupport) { 
showDialog(DLG_SUPPORT); 
return true; 


return false; 


} 


@Override 
protected Dialog onCreateDialog(int id) { 
int i; 
switch (id) { 
case DLG_DEVICE_STATE: 
final CharSequence[] items = getResources().getStringArray(R.array.device_states); 
return new AlertDialog.Builder(this) 
.setTitle(R.string.device state dialog title) 
.setMultiChoiceltems(items, 
new boolean[] { 
Common.getPrefs(this).getBoolean(Common.KEY SPEAK SCREEN OFF, true), 
Common.getPrefs(this).getBoolean(Common.KEY SPEAK SCREEN ON, true), 
Common.getPrefs(this).getBoolean(Common.KEY SPEAK HEADSET OFF, true), 
Common.getPrefs(this).getBoolean(Common.KEY SPEAK HEADSET ON, true), 
Common.getPrefs(this).getBoolean(Common.KEY SPEAK SILENT. ON, false) 


) 
new Dialoginterface.OnMultiChoiceClickListener() { 
@Override 
public void onClick(DialogInterface dialog, int which, boolean isChecked) { 
if (which == 0) { 


Common.getPrefs(MainActivity.this).edit().putBoolean(Common.KEY SPEAK SCREEN OFF, isChecked). 
commit(); 
} else if (which == 1) { 


Common.getPrefs(MainActivity.this).edit().putBoolean(Common.KEY SPEAK SCREEN ON, isChecked). 
commit(); 


(m, 


} else if (which == 2) ( 
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Common.getPrefs(MainActivity.this).edit().putBoolean(Common.KEY SPEAK HEADSET OFF, isChecked). 
commit(); 
} else if (which == 3) { 


Common.getPrefs(MainActivity.this).edit().putBoolean(Common.KEY SPEAK HEADSET ON, isChecked). 
commit(); 
} else if (which == 4) { 


Common.getPrefs(MainActivity.this).edit().putBoolean(Common.KEY_SPEAK_SILENT_ON, isChecked). 
commit(); 


} 
} 


).create(); 
case DLG QUIET START: 
i = Common.getPrefs(this).getint(getString(R.string.key_quietStart), 0); 
return new TimePickerDialog(this, sTimeSetListener, i/60, i%60, false); 
case DLG QUIET END: 
i = Common.getPrefs(this).getInt(getString(R.string.key quietEnd), 0); 
return new TimePickerDialog(this, eTimeSetListener, i/60, i%60, false); 
case DLG_LOG: 
return new AlertDialog.Builder(this) 
.setTitle(R.string.notify log) 
.setView(new NotifyList(this)) 
.setNeutralButton(android.R.string.ok, new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int id) ( 
dialog.dismiss(); 
} 
» 
.create(); 
case DLG SUPPORT: 
return new AlertDialog.Builder(this) 
.setTitle(R.string.support) 
.setitems(R.array.support items, new DialoglInterface.OnClickListener() { 
public void onClick(Dialoginterface dialog, int item) ( 
switch (item) { 
case 0: 
showDialog(DLG_DONATE); 
break; 
case 1: 
Intent iMarket = new Intent(Intent ACTION_VIEW, Uri.parse("market://details? 
id=com. pilot51 .voicenotify")); 
iMarket.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 
try{ 
startActivity(iMarket); 
} catch (ActivityNotFoundException e) { 
e.printStackTrace(); 
Toast makeText(getBaseContext(), R.string.error market, Toast.LENGTH_ 
LONG).show(); 
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break; 
case 2: //Contact developer 
Intent iEmail = new Intent(Intent ACTION_SEND); 
iEmail.setType("plain/text"); 
iEmail.putExtra(IntenLEXTRA EMAIL, new String[] (getString(R.string.dev _ 
email)}); 
iEmail.putExtra(Intent.EXTRA SUBJECT, 
getString(R.string.email subject); 
String version = null; 
try ( 
version = getPackageManager().getPackagelnfo(getPackageName(), 
0).versionName; 
} catch (NameNotFoundException e) { 
e.printStackTrace(); 


} 
iEmail.putExtra(Intent.EXTRA TEXT, 
getString(R.string.email body, 
version, 
Build. VERSION.RELEASE, 
Build.ID, 
Build. MANUFACTURER + "" + 
Build. BRAND + " " + Build. MODEL)); 
try { 
startActivity(iEmail); 
} catch (ActivityNotFoundException e) { 
e.printStackTrace(); 
ToastmakeText(getBaseContext(), R.string.error email, Toast.LENGTH_ 
LONG).show(); 
} 
break; 
case 3: 
startActivity(new Intent(Intent ACTION VIEW, Uri.parse("http://getlocalization. 
com/voicenotify"))); 
break; 
case 4: 
startActivity(new Intent(IntentACTION_VIEW, Uri.parse("https://github.com/ 
pilot51/voicenotify"))); 
break; 
} 
| 
}).create(); 
case DLG_DONATE: 
return new AlertDialog.Builder(this) 
-SetTitle(R.string.donate) 
-Setitems(R.array.donate_services, new DialogInterface.OnClickListener() { 
public void onClick(DialogInterface dialog, int item) { 
switch (item) { 
case 0: 
showWalletDialog(); 
break; 
case 1: 


Boe шеныйли — — 


startActivity(new Intent(IntentACTION_VIEW, Uri.parse("https://paypal.com/ 
cgi-bin/webscr?" 
+"cmd=_donations&business=pilota51%40gmail%2ecom&lc= 
US&item_name=Voice%20Notify&" 
+"no_note=0&no_shipping=1&currency_code=USD"))); 
break; 
} 
} 


}).create(); 


return null; 


} 


private void showWalletDialog() { 
final Intent walletintent = getWalletintent(); 
AlertDialog.Builder dig = new AlertDialog.Builder(this) 
.setTitle(R.string.donate wallet title) 
.setMessage(R.string.donate wallet message) 
.setNegativeButton(android.R.string.cancel, null); 
if (walletIntent != null) ( 
dlg.setPositiveButton(R.string.donate wallet launch app, new Dialoginterface.OnClickListener() 


{ 
@Override 
public void onClick(DialogInterface dialog, int which) { 
startActivity(walletintent); 
} 
}; 
) else { 
dig.setPositiveButton(R.string.donate_wallet_launch_web, new Dialoglnterface. OnClickListener() 
{ 


@Override 
public void onClick(DialogInterface dialog, int which) { 
startActivity(new Intent(Intent.ACTION VIEW, Uri.parse("https://wallet.google.com/ 
manage/# sendMoney:"))); 
} 
}: 


dig.show(); 
} 
pt 
* @return The intent for Google Wallet, otherwise null if installation is not found 
qi 
private Intent getWalletIntent() ( 
try { 
getPackageManager().getPackagelnfo("com.google.android.apps.walletnfcrel" PackageManager. 
GET_ACTIVITIES); 
return new Intent(Intent ACTION_MAIN) 
.setComponent(new ComponentName("com.google.android.apps.walletnfcrel", 
"com.google.android.apps.wallet WalletRootActivity")); 
} catch (PackageManager.NameNotFoundException e) { 
return null; 


) 
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private TimePickerDialog.OnTimeSetListener sTimeSetListener = new TimePickerDialog.OnTime 

SetListener() { 
public void onTimeSet(TimePicker view, int hourOfDay, int minute) { 

Common.getPrefs(MainActivity.this).edit().putint(getString(R.string.key_quietStart), hourOfDay * 60 + 

minute).commit(); 
} 

Е 
private TimePickerDialog.OnTimeSetListener eTimeSetListener = new TimePickerDialog.OnTime 
SetListener() { 

public void onTimeSet(TimePicker view, int hourOfDay, int minute) { 

Common.getPrefs(MainActivity.this).edit().putint(getString(R.string.key_quietEnd), hourOfDay * 60 + 

minute).commit(); 
} 
Е 


private void updateStatus() { 

if (Service.isSuspended() && Service.isRunning()) { 
pStatus.setTitle(R.string.service_suspended); 
pStatus.setSummary(R.string.status_summary_suspended); 
pStatus.setIntent(null); 

}else { 
pStatus.setTitle(Service.isRunning() ? R.string.service running : R.string.service_disabled); 
pStatus.setSummary(R.string.status summary accessibility); 
pStatus.setIntent(getAccessibilityIntent()); 


} 

} 

@Override 

protected void onResume() { 
super.onResume(); 
Common.getPrefs(this).registerOnSharedPreferenceChangeListener(this); 
Service.registerOnStatusChangeListener(statusListener); 
updateStatus(); 

} 

@Override 


protected void onPause() { 
Service.unregisterOnStatusChangeListener(statusListener); 
Common.getPrefs(this).unregisterOnSharedPreferenceChangeListener(this); 
super.onPause(); 


} 


public void onSharedPreferenceChanged(SharedPreferences sp, String key) { 
if (key.equals(getString(R.string.key_ttsStream))) { 
Common.setVolumeStream(this); 
} 
} 
} 


在 上 述 代码 中 ， 在 设备 屏幕 界面 中 加 载 的 是 系统 当前 的 设置 选项 值 。 通 过 上 述 代码 会 监听 当前 


@ 
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户 对 屏幕 选项 的 操作 , 根据 用 户 的 操作 可 以 调用 处 理事 件 重新 设置 自己 想 要 的 选项 , 执行 效果 如 图 6-11 
所 示 。 


Enable/Disable 


App List 
TTS Settings 


TTS Message 


TTS Audio Stream 


TTS Delay 


Ignore Text 


图 6-11 系统 设置 选项 列表 界 F 


(5) 编写 文件 app_list_item.xml， 功 能 是 通过 列表 显示 当前 系统 中 的 APP 程序 。 文 件 app list 
item.xml 的 具体 实现 代码 如 下 : 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
<LinearLayout 
android:layout width-"Odp" 
android:layout height-"wrap content" 
android:layout_weight="1" 
android:orientation="vertical"> 
<TextView 
android:id="@+id/text1" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:textSize="24sp" /> 
<TextView 
android:id="@+id/text2" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 
</LinearLayout> 
<CheckBox 
android:id="@+id/checkbox" 
android:layout_width="40dp" 
android:layout_height="40dp" 
android:layout gravity-"center" 
android:clickable-"false" 
android:focusable="false" 
android:duplicateParentState="true" /> 
</LinearLayout> 


El 
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(6) 编写 文件 AppListjava， 功 能 是 通过 文件 app_list_item.xml 加 载 系统 中 安装 的 APP， 在 列表 
显示 的 APP 中 可 以 设置 是 否 忽略 当前 软件 。 如 果 忽 略 某 一 个 软件 , 这 个 APP 软件 的 通知 信息 将 不 会 被 
语音 识别 提醒 。 文 件 AppListjava 的 具体 实现 代码 如 下 : 

public class AppList extends ListActivity { 


private ListView lv; 

private Adapter adapter; 

private static ArrayList<App> apps; 

private static boolean defEnable; 

private static final String KEY DEFAULT ENABLE = "defEnable"; 

private static final int |GNORE_TOGGLE = 0, IGNORE, ALL = 1, IGNORE_NONE = 2; 
private static final Object SYNC_APPS = new Object(); 

private static OnListUpdateListener listener; 

private static boolean isUpdating; 


@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
Common. .init(this); 
requestWindowFeature(Window.FEATURE INDETERMINATE PROGRESS); 
lv = getListView(); 
lv.setTextFilterEnabled(true); 
adapter = new Adapter(); 
listener = new OnListUpdateListener() ( 
@Override 
public void onListUpdated() ( 
runOnUiThread(new Runnable() { 
public void run() { 
adapter.setData(apps); 
} 
» 
} 


@Override 
public void onUpdateCompleted() { 
runOnUiThread(new Runnable() { 
public void run() { 
setProgressBarindeterminateVisibility(false); 


} 
» 
listener 7 null; 
} 
Е 
lv.setAdapter(adapter); 
lv.setOnltemClickListener(new OnltemClickListener() { 
@Override 
public void onltemClick(AdapterView«?» parent, View view, int position, long id) { 
setlgnore((App)adapter.getltem(position), IGNORE TOGGLE); 
adapter.notifyDataSetChanged(); 
} 
» 


defEnable = Common.getPrefs(this).getBoolean(KEY DEFAULT ENABLE, true); 
updateAppsList(); 
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} 


private interface OnListUpdateListener { 
void onListUpdated(); 
void onUpdateCompleted(); 
} 
private static void onListUpdated() { 
if (listener != null) listener.onListUpdated(); 
} 


private void updateAppsList() { 
setProgressBarlndeterminateVisibility (true); 
if (isUpdating) { 
adapter.setData(apps); 
return; 


} 

isUpdating = true; 

new Thread(new Runnable() { 

public void run() { 
synchronized (SYNC_APPS) { 

apps = Database.getApps(); 
onListUpdated(); 
final boolean isFirstLoad = apps.isEmpty(); 
PackageManager packMan = getPackageManager(); 


for (int a = apps.size() - 1; a >= 0; а--) { 
App арр = apps.get(a); 


try { 

packMan.getApplicationInfo(app.getPackage(), 0); 
} catch (NameNotFoundException e) ( 

if (lisFirsttoad) app.remove(); 

apps.remove(a); 

onListUpdated(); 


) 


inst:for (ApplicationInfo applnfo : packMan.getinstalledApplications(0)) { 
for (App app : apps) { 
if (app.getPackage().equals(applnfo.packageName)) { 
continue inst; 
} 
} 
App app = new App(appinfo.packageName, String.valueOf(applnfo.loadLabel 


(packMan)), defEnable); 


apps.add(app); 

onListUpdated(); 

if (lisFirstLoad) app.updateDb(); 
) 


Collections.sort(apps, new Comparator<App>() ( 
(QOverride 
public int compare(App app1, App app2) ( 
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} 
p; 


return app1.getLabel().compareTolgnoreCase(app2.getLabel()): 

onListUpdated(); 

if (isFirstLoad) Database.setApps(apps); 

} 

isUpdating = false; 

} 
}).start(); 

} 


if (listener != null) listener.onUpdateCompleted(); 


@Override 


public boolean onCreateOptionsMenu(Menu menu) { 
super.onCreateOptionsMenu(menu); 


getMenulnflater().inflate(R.menu.app_list, menu); 
return true; 
} 


@Override 


public boolean onOptionsltemSelected(Menultem item) { 
switch (item.getltemld()) { 
case R.id.ignore_all: 
setDefaultEnable(false); 
masslgnore(IGNORE ALL); 
return true; 
case R.id.ignore none: 
setDefaultEnable(true); 
masslgnore(IGNORE. NONE); 
return true; 
case R.id filter: 


return true; 
) 


((InputMethodManager)getSystemService(Context.INPUT METHOD SERVICE)).toggleSoftInput(0, 0); 
return false; 
} 


r 


searching system. 


* @param pkg Package name used to find (link App) in current list or create a new one from system. 
F 


static App findOrAddApp(String pkg, Context ctx) { 
synchronized (SYNC_APPS) { 


* @param ctx Context required to get default enabled preference and to get package manager for 
if (apps == null) { 


* @return Found or created {@link App}, otherwise null if app not found on system. 


} 


defEnable = Common.getPrefs(ctx).getBoolean(KEY_DEFAULT_ENABLE, true); 
apps = Database.getApps(); 
for (App app : apps) { 
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if (app.getPackage().equals(pkg)) ( 
return app; 
} 


} 
try { 
PackageManager packMan = ctx.getPackageManager(); 
App арр = new App(pkg, packMan.getApplicationInfo(pkg, 0).loadLabel(packMan). 
toString(), defEnable); 
apps.add(app.updateDb()); 
return app; 
} catch (NameNotFoundException e) { 
e.printStackTrace(); 
return null; 


} 


private void masslgnore(int ignoreType) { 
for (App app : apps) { 
setlgnore(app, ignoreType); 


) 
adapter.notifyDataSetChanged(); 
new Thread(new Runnable() ( 
public void run() ( 
Database.setApps(apps); 


) 
}).start(); 


private void setignore(App app, int ignoreType) { 
if (lapp.getEnabled() & (ignoreType == IGNORE_TOGGLE | ignoreType == IGNORE_NONE)) { 
app.setEnabled(true, ignoreType == IGNORE_TOGGLE); 
if (ignoreType == IGNORE_TOGGLE) { 
Toast.makeText(this, getString(R.string.app is not ignored, app.getLabel()), Toast.LENGTH_ 
SHORT).show(); 


} 

} else if (app.getEnabled() & (ignoreType == IGNORE_TOGGLE | ignoreType == IGNORE_ALL)) { 
app.setEnabled(false, ignoreType == IGNORE TOGGLE); 
if (ignoreType == IGNORE TOGGLE) ( 

Toast.makeText(this, getString(R.string.app is ignored, app.getLabel()), Toast. LENGTH - 
SHORT).show(); 

) 

} 

} 


private void setDefaultEnable(boolean enable) { 
defEnable = enable; 


Common.getPrefs(this).edit().putBoolean(KEY_DEFAULT_ENABLE, defEnable).commit(); 
} 


private class Adapter extends BaseAdapter implements Filterable { 
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private final ArrayList<App> baseData = new ArrayList<App>(); 
private final ArrayList<App> adapterData = new ArrayList<App>(); 
private LayoutInflater minflater; 

private SimpleFilter filter; 


private Adapter() { 
minflater = (Layoutinflater)getSystemService(Context.LAYOUT INFLATER SERVICE); 
} 


private void setData(ArrayList<App> list) { 
baseData.clear(); 
baseData.addAIl(list); 


refresh(); 

) 

private void refresh() ( 
adapterData.clear(); 
adapterData.addAll(baseData); 
notifyDataSetChanged(); 

} 

@Override 


public int getCount() { 
return adapterData.size(); 


} 


@Override 

public Object getltem(int position) { 
return adapterData.get(position); 

} 


@Override 
public long getltemld(int position) { 
return position; 


} 


@Override 

public View getView(int position, View view, ViewGroup parent) { 
if (view == null) { 

view = minflater.inflate(R.layout.app_list_item, parent, false); 

} 
((TextView)view.findViewByld(R.id.text1)).setText(adapterData.get(position).getLabel()); 
((TextView)view.findViewByld(R.id.text2)).setT ext(adapterData.get(position).getPackage()); 
((CheckBox)view.findViewById(R.id.checkbox)).setChecked(adapterData.get(position).getEnabled()); 
return view; 


) 


@Override 

public Filter getFilter() { 
if (filter == null) filter = new SimpleFilter(); 
return filter; 


(m, 
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private class SimpleFilter extends Filter { 
@Override 
protected FilterResults performFiltering(CharSequence prefix) { 
FilterResults results = new FilterResults(); 
if (prefix == null || prefix.length() == 0) { 
results.values = baseData; 
results.count = baseData.size(); 
) else ( 
String prefixString = prefix.toString().toLowerCase(); 
ArrayList<App> newValues = new ArrayList<App>(); 
for (App app : baseData) { 
if (app.getLabel().toLowerCase().contains(prefixString) 
|| app.getPackage().toLowerCase().contains(prefixString)) { 
newValues.add(app); 
} 
} 


results.values = newValues; 
results.count = newValues.size(); 


return results; 


) 
@SuppressWarnings("unchecked") 
@Override 
protected void publishResults(CharSequence constraint, FilterResults results) { 
adapterData.clear(); 
adapterData.addAll((ArrayList<App>)results.values); 
if (results.count > 0) notifyDataSetChanged(); 
else notifyDataSetInvalidated(); 
) 


) 
) 


在 上 述 代码 中 ， 应 用 程序 会 监听 用 户 对 列表 中 某 个 应 用 程序 复 选 框 的 操作 ， 根 据 用户 是 否 选中 这 
个 选项 来 设置 是 否 忽 略 。 执 行 效果 如 图 6-12 所 和 = 


图 


图 6-12 设置 界面 
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(7) 编写 文件 notify log item.xml， 功 能 是 通过 文本 框 控件 显示 当前 选项 的 设置 信息 ， 有 具体 实现 
代码 如 下 : 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 

android:layout width-"match parent" 

android:layout height-"wrap content" 

android:orientation-" vertical" 

<TextView 
android:id="@+id/time" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:gravity-"center" /> 

<TextView 
android:id="@+id/title" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:textSize="24sp" /> 

<TextView 
android:id="@+id/message" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:gravity="center" 
android:textSize="16sp" /> 

<TextView 
android:id="@+id/ignore_reasons" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:gravity="center" /> 

</LinearLayout> 


(8) 编写 文件 NotifyListjava， 功 能 是 通过 文件 notify log item.xml 载 入 布局 控件 来 显示 界面 ， 在 
显示 列表 中 根据 选项 的 ID 值 显示 对 应 的 选项 的 辅助 信息 ， 包 括 时 间 、 是 否 忽略 、 忽 略 原因 、 位 置 、 提 
醒 信息 大 小 等 。 文 件 NotifyListjava 的 具体 实现 代码 如 下 : 

public class NotifyList extends ListView { 
private Resources res; 
private static ArrayList<Notifyltem> list = new ArrayList<Notifyltem>(); 
private Adapter adapter; 
private static OnListChangeListener listener; 
private static final int HISTORY. LIMIT = 20; 


NotifyList(Context context) { 
super(context); 
res = getResources(); 
setDivider(res.getDrawable(R.drawable.divider)); 
adapter = new Adapter(context, list); 
setAdapter(adapter); 

} 


static void addNotification(App app, String message) { 
if (list.size() == HISTORY_LIMIT) { 
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list.remove(list.size() - 1); 
} 
list.add(0, new Notifyltem(app, message)); 
if (listener != null) { 
listener.onListChange(); 
} 
} 


static void setLastlgnore(String ignoreReasons, boolean isNew) { 
if (list.isEmpty()) return; 
list.get(0).setlgnoreReasons(ignoreReasons, isNew); 
if (listener != null) { 
listener.onListChange(); 
} 
} 


private static class Notifyltem { 
private App app; 
private String message, ignoreReasons, time; 
private SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss"); 
private boolean silenced; 


private Notifyltem(App app, String message) { 
this.app = app; 
this. message = message; 
time = sdf.format(Calendar.getinstance().getTime()); 


} 

private App getApp() { 
return app; 

} 


private String getMessage() { 
return message; 


} 


private String getlgnoreReasons() { 
return ignoreReasons; 


} 


void setlgnoreReasons(String reasons, boolean isNew) { 
silenced = lisNew; 
ignoreReasons = reasons; 


} 

private String getTime() { 
return time; 

} 


} 


private static interface OnListChangeListener { 
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void onListChange(); 
| 


private class Adapter extends BaseAdapter { 
private ArrayList<Notifyltem> data; 
private Layoutinflater minflater; 


private Adapter(final Context context, ArrayList<Notifyltem> list) ( 
data = list; 
minflater = (Layoutinflater)context.getSystemService(Context.LAYOUT INFLATER SERVICE); 
listener = new OnListChangeListener() ( 
@Override 
public void onListChange() { 
((Activity)context).runOnUiThread(new Runnable() { 
public void run() { 
notifyDataSetChanged(); 
} 
» 


) 


@Override 
public int getCount() { 
return data.size(); 


} 


@Override 

public Object getltem(int position) { 
return data.get(position); 

} 


@Override 

public long getltemld(int position) ( 
return position; 

) 


@Override 
public View getView(int position, View convertView, ViewGroup parent) { 
View view = convertView; 
if (view == null) { 
view = minflater.inflate(R.layout.notify_log_item, parent, false); 
} 
final Notifyltem item = data.get(position); 
((TextView)view.findViewByld(R.id.time)).setText(item.getTime()); 
((TextView)view.findViewByld(R.id.title)).setText(item.getApp().getLabel()); 
TextView textView = (TextView)view.findViewByld(R.id.message); 
if (item.getMessage().length() != 0) { 
textView.setText(item.getMessage()); 
textView.setVisibility(TextView. VISIBLE); 
} else textView.setVisibility( TextView. GONE); 
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textView = (TextView)view.findViewByld(R.id.ignore_reasons); 
if (item.getlgnoreReasons() != null && item.getlgnoreReasons().length() {= 0) { 
textView.setText(item.getlgnoreReasons()); 
if (item.silenced) textView.setTextColor(Color. YELLOW); 
else textView.setTextColor(Color.RED); 
textView.setVisibility(TextView. VISIBLE); 
} else textView.setVisibility(TextView. GONE); 
view.setOnLongClickListener(new OnLongClickListener() { 
@Override 
public boolean onLongClick(View v) { 
new AlertDialog.Builder(getContext()) 
-SetTitle(res.getString(item.getApp().getEnabled() 
? R.string.ignore app 
: Restring.unignore арр, 
item.getApp().getLabel())) 
.setPositiveButton(R.string.yes, new DialogInterface.OnClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which) { 
item.getApp().setEnabled(litem.getApp().getEnabled(), true); 
Toast.makeText(getContext(), res.getString(item.getApp().getEnabled() 
? R.string.app_is_not_ignored 
: R.string-app_is_ignored, 
item.getApp().getLabel()), 
Toast.LENGTH_SHORT).show(); 


} 
» 
.setNegativeButton(android.R.string.cancel, null) 
.show(); 
return false; 
) 
}: 
return view; 


} 

} 

(9) 本 实例 中 使 用 了 SQLite 数据 库 , 在 里 面 保存 当前 系统 中 各 个 选项 的 设置 值 。 编写 文件 Database. 
java， 通 过 SQL 语句 实现 对 各 个 选项 当前 设置 值 的 查询 、 修 改 和 删除 功能 。 文 件 Database java 的 具体 
实现 代码 如 下 : 

public class Database extends SQLiteOpenHelper { 

private static String ТАС = Database.class.getSimpleName(); 
private Context context; 
private static Database database; 
private static final int DB. VERSION = 1; 
private static final String 
OLD FILE = "ignored apps", 
DB NAME - "apps.db", 
TABLE. NAME = "apps", 
COLUMN PACKAGE = "package", 
COLUMN LABEL - "name", 
COLUMN ENABLED - "is enabled", 
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CREATE_TBL_APPS = "create table if not exists " + TABLE NAME + "(" + BaseColumns. ID 
+" integer primary key autoincrement, " + COLUMN PACKAGE + " text not null, " 
+ COLUMN LABEL +" text not null, " + COLUMN ENABLED +" integer);"; 


private Database(Context context) ( 
super(context, DB NAME, null, DB VERSION); 
this.context = context.getApplicationContext(); 
try { 
if (Icontext.getDatabasePath(DB NAME ).exists() 
&& new File(context.getFilesDir().toString() + File.separatorChar + OLD FILE).exists()) { 
upgradeOldlgnores(); 


} 

} catch (Exception e) { 
Log.w(TAG, "Error checking for old ignores to be transferred to database."); 
e.printStackTrace(); 


p 
* 如 果 尚 未 初始 化 数据 库 <br /> 

* Call {@link #getinstance()} to get the static instance. 
N 
static void init(Context context) { 

if (database != null) { 

Log.w(TAG, "Database already initialized!"); 
}else database = new Database(context); 


} 


/^* @ 返 回 先前 初始 化 静态 数据 库 实例 ， 如 果 {@link ##nit(Context} 没 有 执行 则 返回 null*/ 
static Database getinstance() { 
if (database == null) { 
Log.w(TAG, "Database not initialized!"); 
} 


return database; 


} 


/从 旧 的 数据 库 副本 忽略 文件 并 删除 旧 的 文件 "/ 
@SuppressWarnings("unchecked") 
void upgradeOldlgnores() { 
ArrayList<String> oldList = new ArrayList<String>(); 
FilelnputStream file = null; 
try { 
file = context.openFilelnput(OLD FILE); 
} catch (FileNotFoundException e) {} 
try { 
ObjectinputStream in = new ObjectinputStream(file); 
try{ 
oldList = (ArrayList<String>)in.readObject(); 
} catch (ClassNotFoundException e) { 
Log.e(TAG, "Error: Failed to read ignored_apps - Data appears corrupt"); 
e.printStackTrace(); 
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in.close(); 
} catch (IOException e) { 
Log.e(TAG, "Error: Failed to read ignored_apps"); 
e.printStackTrace(); 
} 
ArrayList<App> newList = new ArrayList<App>(); 
PackageManager packMan = context.getPackageManager(); 
ApplicationInfo арріпїо; 
for (String s : oldList) { 
try { 
appinfo = packMan.getApplicationInfo(s, PackageManager.GET UNINSTALLED PACKAGES); 
newList.add(new App(applnfo.packageName, String.valueOf(applnfo.loadLabel (packMan)), 


false)); 
} catch (NameNotFoundException e) ( 
e.printStackTrace(); 
) 
) 
setApps(newList); 
context.deleteFile(OLD FILE); 
) 


/* @ 返 回 一 个 新 的 列表 包含 从 数据 库 中 所 有 的 应 用 程序 */ 
static synchronized ArrayList<App> getApps() { 
SQLiteDatabase db = database.getReadableDatabase(); 
Cursor cursor = db.query(TABLE_NAME, null, null, null, null, null, COLUMN LABEL + " COLLATE 
NOCASE"); 
ArrayList<App> list = new ArrayList<App>(); 
while (cursor.moveToNext()) { 
list.add(new App( 
cursor.getString(cursor.getColumnindex(COLUMN_PACKAGE)), 
cursor.getString(cursor.getColumnindex(COLUMN_LABEL)), 
cursor.getint(cursor.getColumnindex(COLUMN_ENABLED)) == 
)); 
} 
cursor.close(); 
db.close(); 
return list; 


} 
p. 


* 清 除 并 设置 数据 库 中 的 所 有 程序 集 
* @рагат list The list of apps to add in the database. 
on 
static synchronized void setApps(ArrayList<App> list) { 
SQLiteDatabase db = database. getWritableDatabase(); 
db.delete(TABLE_NAME, null, null); 
ContentValues values; 
for (App app : list) { 
values = new ContentValues(); 
values.put(COLUMN PACKAGE, app.getPackage()); 
values.put(COLUMN LABEL, app.getLabel()); 
values.put(COLUMN ENABLED, app.getEnabled() ? 1 : 0); 
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db.insert(TABLE NAME, null, values); 

} 

db.close(); 
} 
n 

* 如 果 没 有 找到 匹配 的 ， 更 新 应 用 程序 数据 库 中 匹配 的 包 的 名 称 或 补充 

* @рагат app The app to add or update in the database. 
si 
static synchronized void addOrUpdateApp(App app) ( 

ContentValues values = new ContentValues(); 

values.put(COLUMN PACKAGE, app.getPackage()); 

values.put(COLUMN LABEL, app.getLabel()); 

values.put(COLUMN ENABLED, app.getEnabled() ? 1 : 0); 

SQLiteDatabase db = database.getWritableDatabase(); 

if (db.update(TABLE NAME, values, COLUMN PACKAGE + " = ?", new String[] {app.getPackage()}) 


== 0){ 


db.insert(TABLE_NAME, null, values); 
} 
db.close(); 
} 


p 
* 更 新 应 用 程序 启用 的 数据 库 匹 配 包 名 称 值 
* @param app The app to update in the database 
| 

static synchronized void updateAppEnable(App app) { 

ContentValues values = new ContentValues(); 

values.pu(COLUMN ENABLED, app.getEnabled() ? 1 : 0); 

SQLiteDatabase db = database.getWritableDatabase(); 

db.update(TABLE NAME, values, COLUMN PACKAGE + "= ?", new String[] (app.getPackage())); 
db.close(); 

) 

p 
* 删 除 应 用 程序 数据 库 匹 配 的 包 名 

* @param app The app to remove from the database 

static synchronized void removeApp(App app) ( 

SQLiteDatabase db = database.getWritableDatabase(); 
db.delete(TABLE_NAME, COLUMN PACKAGE + "= ?", new String[] (app.getPackage())); 
db.close(); 

} 


@Override 

public void onCreate(SQLiteDatabase db) { 
db.execSQL(CREATE_TBL_APPS); 

} 


@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {} 
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(Q0) 为 了 方便 用 户 及 时 取消 语音 提醒 功能 ， 编 写 文件 Shake.java， 功 能 是 通过 摇晃 设备 的 方式 取 
消 语音 提醒 功能 。 文 件 Shake java 的 具体 实现 代码 如 下 : 
public class Shake implements SensorEventListener { 
private final Context context; 
private final SensorManager manager; 
private final Sensor sensor; 
private OnShakeListener listener; 
private int threshold, overThresholdCount; 
private float accelCurrent, accelLast; 


Shake(Context c) ( 
context 7 c; 
manager = (SensorManager)c.getSystemService(Context.SENSOR SERVICE); 
sensor = manager.getDefaultSensor(Sensor. TYPE ACCELEROMETER); 


) 

void enable() ( 
if (listener == null) return; 
try( 


threshold = Integer.parselnt(Common.getPrefs(context).getStrin g(context.getString(R.string. 
key. shake threshold), null)); 
} catch (NumberFormatException e) { 


return; 

} 

manager.registerListener(this, sensor, SensorManager.SENSOR_DELAY_NORMAL); 
} 
void disable() { 

manager.unregisterListener(this); 

accelCurrent = 0; 

accelLast = 0; 

overThresholdCount - 0; 
) 


void setOnShakeListener(OnShakeListener listener) ( 
this.listener = listener; 
} 


@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) {} 


@Override 
public void onSensorChanged(SensorEvent event) { 
float x = event.values[0]; 
float y = event.values[1]; 
float z = event.values[2]: 
accelCurrent = (float)Math.sqrt(x * x + y * y + z * z); 
float accel = accelCurrent - accelLast: 
if (accelLast != 0 && Math.abs(accel) > threshold / 10) { 
overThresholdCount++; 
if (overThresholdCount >= 2) { 
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listener.onShake(); 


} 
) else { 
overThresholdCount = 0; 


} 


accelLast = accelCurrent; 


} 


interface OnShakeListener { 
void onShake(); 
} 
} 


至 此 ， 整 个 实例 介绍 完毕 。 目 前 本 实例 只 是 支持 英语 、 德 语 、 法 语 、 西 班 牙 语 、 匈 牙 利 语 、 俄 语 
和 意大利 语 ， 这 一 点 从 本 项 目的 工程 结构 中 可 以 看 出 ， 如 图 6-13 所 示 。 

另外 ， 本 项 目 己 经 在 谷歌 市 场 中 发 布 ， 地 址 是 https://play.google.com/store/apps/details?id=com.pilot51. 
voicenotify， 名 称 是 Voice Notify， 读 者 可 以 下 载 安装 并 体会 ， 如 图 6-14 所 示 。 


Voice Notify 


=) values-de 


strings. xml 


=) values-es 
strings. xml 
1-05 values-fr 
strings. xml 
EB values-hu-rHU 
strings. xml 
Є}-@ values-it 
strings. xml 
S-S values-ru 


strings, xml 


图 6-13 支持 的 语言 图 6-14 谷歌 市 场 上 的 本 项 目 


第 7 章 手势 识别 实战 


手势 识别 技术 是 Android SDK 中 比较 重要 并 且 比 较 新 颖 的 一 项 技术 ， 在 Android 物 联网 设备 应 用 
中 可 以 通过 手势 来 灵活 地 操控 设备 的 运行 。 本 章 将 详细 讲解 在 Android 物 联网 设备 中 使 用 手势 识别 技 
术 的 基本 知识 和 具体 方法 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打下 基础 。 


7.1 Android 中 的 事件 监听 机 制 


EB 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 7 3h Android 中 的 事件 监听 机 制 .avi 
本 书 前 面 的 内 容 中 ， 已 经 多 次 用 到 了 Android 事件 监听 机 制 ， 例 如 监听 是 否 单 击 屏 幕 、 是 否 触摸 
单 击 了 某 个 按钮 等 。 本 节 将 详细 讲解 Android 系统 中 事件 监听 机 制 的 基本 知识 。 


7.1.1 Android 系统 中 的 监听 事件 


在 Android 应 用 开发 过 程 中 ， 存 在 如 下 所 示 的 常用 监听 事件 。 
(1) ListView 事件 监听 

I] setOnltemSelectedListener: 鼠标 滚动 时 触发 。 

B setOnltemClickListener: 点 击 时 触发 。 
(2) EditText 事件 监听 

E] setOnKeyListener: 获取 焦点 时 触发 。 
(3) RadioGroup 事件 监听 

B setOnCheckedChangelistener: 点 击 时 触发 。 
(4) CheckBox 事件 监听 

Е setOnCheckedChangelistener: 点 击 时 触发 。 
(5) Spinner 事件 监听 

E] setOnltemSelectedListener: 点 击 时 触发 。 
(6) DatePicker 事件 监听 

M onDateChangedListener: 日 期 改变 时 触发 。 
(7) DatePickerDialog 事件 监听 

E] onDateSetListener: 设置 日 期 时 触发 。 
(8) TimePicker 事件 监听 

回 onTimeChangedListener: 时 间 改 变 时 触发 。 
(9) TimePickerDialog 事件 监听 

onTimeSetListener: 设置 时 间 时 触发 。 
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(10) Button、ImageButton 事件 监听 
setOnClickListener: 点 击 时 触发 。 
(11) Menu 事件 监听 
onOptionsItemSelected: 点 击 时 触发 。 
(12) Gallery 事件 监听 
setOnItemClickListener: 点 击 时 触发 。 
(13) GridView 事件 监听 
setOnItemClickListener: 点 击 时 触发 。 


7.1.2 Android 事件 监听 器 的 回调 方法 


在 Android 操作 系统 中 ， 对 于 事件 的 处 理 是 一 个 非常 基础 而 且 重 要 的 操作 ， 很 多 功能 都 需要 对 相 
关 事件 进行 触发 才能 实现 。 例 如 Android 事件 监听 器 是 视图 View 类 的 接口 , 包含 一 个 单独 的 回调 方法 。 
这 些 方法 将 在 视图 中 注册 的 监听 器 被 用 户 界面 操作 触发 时 由 Android 框架 调用 。 在 现实 应 用 中 ， 如 下 
所 示 的 回调 方法 被 包含 在 Android 事件 监听 器 接口 中 。 
(1) onClick() 
包含 于 View.OnClickListener。 当 用 户 触 摸 这 个 item (在 触摸 模式 下 ), 或 者 通过 浏览 键 或 跟踪 球 聚 
焦 在 这 个 пеш 上 ， 然 后 按 下 “确认 ” 键 或 者 按 下 跟踪 球 时 被 调用 。 
(2) onLongClick() 
包含 于 View.OnLongClickListener。 当 用 户 触 摸 并 按 住 这 个 item (在 触摸 模式 下 )， 或 者 通过 浏览 
键 或 跟踪 球 聚 焦 在 这 个 пеш 上 ， 然 后 保持 按 下 “确认 ” 键 或 者 按 下 跟踪 球 〈 一 秒 钟 ) 时 被 调用 。 
(3) onFocusChange() 
包含 于 View.OnFocusChangeListener。 当 用 户 使 用 浏览 键 或 跟踪 球 浏览 进入 或 离开 这 个 item 时 被 
调用 。 
(4) onKey() 
包含 于 View.OnKeyListener。 当 用 户 聚 焦 在 这 个 пеш 上 并 按 下 或 释放 设备 上 的 一 个 按键 时 被 调用 。 
(5) onTouch() 
包含 于 View.OnTouchListener。 当 用 户 执行 的 动作 被 当 作 一 个 触摸 事件 时 被 调用 , 包括 按 下 、 释放 ， 
或 者 屏幕 上 任何 的 移动 手势 (在 这 个 пеш 的 边界 内 )。 
(6) onCreateContextMenu() 
包含 于 View.OnCreateContextMenuListener。 当 正在 创建 一 个 上 下 文 菜 单 时 被 调用 (作为 持续 的 “长 
点 击 ” 动 作 的 结果 )。 
上 述 方法 是 它们 相应 接口 的 唯一 “住户 ”。 要 定义 这 些 方法 并 处 理事 件 ， 需 要 在 活动 中 实现 这 个 髓 
套 接口 或 定义 它 为 一 个 匿名 类 。 然 后 传递 一 个 实例 给 各 自 的 View.set...Listener0 方 法 。 例 如 调用 seton 
ClickListener() 并 传递 给 它 OnClickListener 实现 。 
下 面 的 代码 演示 了 为 一 个 按钮 注册 一 个 点 击 监听 器 的 方法 。 
private OnClickListener mCorkyListener = new OnClickListener() { 
public void onClick(View v) { 


} 
Б 


e. 


protected void onCreate(Bundle savedValues) { 


Button button = (Button)findViewByld(R.id.corky); 
button.setOnClickListener(mCorkyListener); 


此 时 可 能 会 发 现 ， 把 OnClickListener 作为 活动 的 一 部 分 来 实现 会 简便 很 多 ， 这 样 可 以 避免 额外 的 
类 加 载 和 对 象 分 配 。 例 如 下 面 的 演示 代码 。 

public class ExampleActivity extends Activity implements OnClickListener { 

protected void onCreate(Bundle savedValues) { 


Button button = (Button)findViewByld(R.id.corky); 
button.setOnClickListener(this); 


} 
public void onClick(View v) { 


} 


} 
上 述 代码 中 的 onClickO 回 调 没有 返回 值 ， 但 是 一 些 其 他 Android 事件 监听 器 必须 返回 一 个 布尔 值 。 
原因 和 事件 相关 ， 具 体 原因 如 下 所 示 。 
onLongClick(): 返回 一 个 布尔 值 来 指示 用 户 是 否 已 经 消费 了 这 个 事件 而 不 应 该 再 进一步 处 理 
它 。 也 就 是 说 ， 返 回 true 表示 用 户 已 经 处 理 了 这 个 事件 而 且 到 此 为 止 ， 返回 false 表示 用 户 还 
没有 处 理 和 /或 这 个 事件 应 该 继续 交 给 其 他 on-click 监听 器 。 
onKeyQ: 返回 一 个 布尔 值 来 指示 用 户 是 否 已 经 消费 了 这 个 事件 而 不 应 该 再 进一步 处 理 它 。 也 
就 是 说 ， 返 回 true 表示 用 户 已 经 处 理 了 这 个 事件 而 且 到 此 为 止 ; 返回 false 表示 用 户 还 没有 处 
理 和 /或 这 个 事件 应 该 继续 交 给 其 他 on-key 监听 器 。 
onTouch(): 返回 一 个 布尔 值 来 指示 用 户 的 监听 器 是 否 已 经 消费 了 这 个 事件 。 重 要 的 是 这 个 事 
件 可 以 有 多 个 彼此 跟随 的 动作 。 因 此 ， 如 果 当 接收 到 向 下 动作 事件 时 返回 false， 那 表明 用 户 
还 没有 消费 这 个 事件 而 且 对 后 续 动作 也 不 感 兴趣 。 那 么 ， 用 户 将 不 会 被 该 事件 中 的 其 他 动作 
调用 ， 例 如 手势 或 最 后 出 现 向 上 动作 事件 。 
在 Android 应 用 中 ， 按 键 事 件 总 是 递交 给 当前 焦点 所 在 的 视图 。 它 们 从 视图 层次 的 顶层 开始 被 分 
发 ， 然 后 依次 向 下 ， 直 到 到 达 恰当 的 目标 。 如 果 视 图 (或 者 一 个 子 视图 ) 当前 拥有 焦点 ， 那 么 可 以 看 
到 事件 经 由 dispatchKeyEvent( 方 法 分 发 .除了 视图 截获 按键 事件 外 , 还 可 以 在 活动 中 使 用 onKeyDown() 
和 onKeyUp0 来 接收 所 有 的 事件 。 


注意 : Android 将 首先 调用 事件 处 理 器 ， 其 次 是 类 定义 中 合适 的 默认 处 理 器 。 这样， 当 从 这 些 事件 监听 
器 中 返回 true 时 会 停止 事件 向 其 他 Android 事件 监听 器 传播 ， 并 且 也 会 阻塞 视图 中 的 此 事件 处 
理 器 的 回调 函数 。 所 以 ， 当 返回 true 时 需要 确认 是 否 希 望 终 止 这 个 事件 。 


7.1.3 Android 事件 处 理 的 两 种 模型 


在 Android 系统 中 提供 了 两 种 方式 的 事件 处 理 ， 分 别 是 基于 回调 的 事件 处 理 和 基于 监听 器 的 事件 
处 理 。 对 于 基于 监听 器 的 事件 处 理 而 言 ， 主 要 就 是 为 Android 界面 组 件 绑 定 特定 的 事件 监听 器 ， 对 于 
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基于 回调 的 事件 处 理 而 言 ， 主 要 的 做 法 是 重 写 Android 组 件 特定 的 回调 函数 ，Android 的 大 部 分 界面 组 
件 都 提供 了 事件 响应 的 回调 函数 ， 只 要 重 写 它们 即 可 。 


1. 基于 监听 器 的 事件 处 理 


在 基于 监听 器 的 事件 处 理 的 监听 器 模型 中 ， 主 要 涉及 如 下 3 类 对 象 。 

М ”事件 源 Event Source: 产生 事件 的 来 源 ， 通 常 是 各 种 组 件 ， 如 按钮 、 窗 口 等 。 

М FfF Event: 事件 封装 了 界面 组 件 上 发 生 的 特定 事件 的 具体 信息 ， 如 果 监 听 器 需要 获取 界面 组 

件 上 所 发 生 事件 的 相关 信息 ， 一 般 通过 事件 Event 对 象 来 传递 。 

事件 监听 器 Event Listener: 负责 监听 事件 源 发 生 的 事件 ， 并 对 不 同 的 事件 做 相应 的 处 理 。 

基于 监听 器 的 事件 处 理 机 制 是 一 种 委派 式 Delegation 的 事件 处 理 方式 ， 事 件 源 将 整个 事件 委托 给 
事件 监听 器 ， 由 监听 器 对 事件 进行 响应 处 理 。 这 种 处 理 方式 将 事件 源 和 事件 监听 器 分 离 ， 有 利于 提供 
程序 的 可 维护 性 。 

PM, View 类 中 的 OnLongClickListener 监听 器 不 需要 传递 事件 ， 演 示 代 码 如 下 : 


public interface OnLongClickListener { 
boolean onLongClick(View v); 


} 
例如 ，View 类 中 的 OnLongClickListener 监听 器 定义 如 下 ， 需 要 传递 事件 MotionEvent。 
public interface OnTouchListener { 

boolean onTouch(View v, MotionEvent event); 


} 
2. 基于 回调 的 事件 处 理 


相 比 基于 监听 器 的 事件 处 理 模型 ， 基 于 回调 的 事件 处 理 模型 要 简单 一 些 ， 该 模型 中 ， 事 件 源 和 事 
件 监 听 器 是 合 一 的 ， 也 就 是 说 没有 独立 的 事件 监听 器 存在 。 当 用 户 在 GUI 组 件 上 触发 某 事件 时 ， 由 该 
组 件 自身 特定 的 函数 负责 处 理 该 事件 。 通常 通过 重 写 Override 组 件 类 的 事件 处 理 函 数 实现 事件 的 处 理 。 
例如 ，View 类 实现 了 KeyEvent.Callback 接口 中 的 一 系列 回调 函数 ,所 以 基于 回调 的 事件 处 理 机 制 
通过 自 定 义 View 来 实现 ， 自 定义 View 时 重 写 这 些 事件 处 理 方法 即 可 。 具 体 演 示 代 码 如 下 : 
public interface Callback { 
// 几 乎 所 有 基于 回调 的 事件 处 理 函 数 都 会 返回 一 个 boolean 类 型 值 ， 该 返回 值 用 于 
/标识 该 处 理 函 数 是 否 能 完全 处 理 该 事件 
/返回 true， 表 了 明 该 函数 已 完全 处 理 该 事件 ， 该 事件 不 会 传播 出 去 
/返回 false， 表 明 该 函数 未 完全 处 理 该 事件 ， 该 事件 会 传播 出 去 
boolean onKeyDown(int keyCode, KeyEvent event); 
boolean onKeyLongPress(int keyCode, KeyEvent event); 
boolean onKeyUp(int keyCode, KeyEvent event); 
boolean onKeyMultiple(int keyCode, int count, KeyEvent event); 
} 
由 此 可 见 ， 基 于 监听 器 的 事件 模型 符合 单一 职责 原则 ， 事 件 源 和 事件 监听 器 分 开 实现 。Android 的 
事件 处 理 机 制 保证 基于 监听 器 的 事件 处 理会 优先 于 基于 回调 的 事件 处 理 被 触发 。 在 某 些 特定 情况 下 ， 
基于 回调 的 事件 处 理 机 制 会 更 好 地 提高 程序 的 内 聚 性 。 


7.14 基于 自 定义 监听 器 的 事件 处 理 流程 


在 实际 项 目 开 发 中 ， 经 常 需要 自 定义 监听 器 来 实现 自 定 义 业务 流程 的 处 理 ， 而 且 一 般 都 不 是 基于 


б 
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GUI 界面 作为 事件 源 的 。 这 里 以 常见 的 app 自动 更 新 为 例 进 行 说 明 ， 在 自动 更 新 过 程 中 ， 会 存在 两 个 


状态 : 下 载 中 和 下 载 完成 ， 而 程序 需要 在 这 两 个 状态 做 不 同 的 事情 ,“ 下 载 中 ”需要 在 UI 界面 上 实时 
显示 软件 包 下 载 的 进度 ,“ 下 载 完 成 ”后 ， 取 消 进度 条 的 显示 。 这 里 进行 一 个 模拟 ， 重 点 在 于 说 明 自 定 


义 监听 器 的 事件 处 理 流程 。 
O) 定义 事件 监听 器 ， 有 具体 代码 如 下 : 


public interface DownloadListener{ 
public void onDownloading(int progress); /下 载 过 程 中 的 处 理 函 数 
public void onDownloaded(); /1 下载 完 成 的 处 理 函 数 


} 
(2) 实现 下 载 操作 的 工具 类 ， 具 体 代码 如 下 : 
public class DownloadUtils { 
private static DownloadUtils instance = null; 
private DownloadUtils() { 
Í 
public static synchronized DownloadUtils instance() ( 
if (instance == null) { 
instance = new DownloadUtils(); 
} 
return instance; 


} 
private boolean isDownloading = true; 
private int progress = 0; 


/实际 开发 中 这 个 函数 需要 传 入 ип 作为 参数 ， 以 获取 服务 器 端的 安装 包 位 置 
public void download(DownloadListener listener) throws InterruptedException { 
while (isDownloading) { 

listener.onDownloading(progress); 

/下 载 过 程 的 简单 模拟 

Thread.sleep(1000); 

progress += 10; 

if (progress >= 100) { 

isDownloading = false; 


} 


} 
/下 载 完成 
listener.onDownloaded(); 
} 
} 
(3) 在 main 函数 中 模拟 事件 源 ， 具 体 代码 如 下 : 
public class DownloadUI { 


public static void main(String[] args) ( 
try { 
DownloadUtils.instance().download(new MyDownloadListener()); 
) catch (InterruptedException e) ( 
e.printStackTrace(); 
} 
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} 


private static class MyDownloadListener implements DownloadListener { 


@Override 
public void onDownloading(int progress) { 


System.out.printin(" 下 载 进度 是 : "+ progress); 


} 


@Override 

public void onDownloaded() { 
System.out.printin(" T $& 5c Ei"); 

) 


} 
} 
运行 上 面 的 模拟 程序 ， 执 行 效果 如 图 7-1 所 示 。 


下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 
下 载 进度 是 : 


те 


图 7-1 执行 效果 
7.2 手势 识别 技术 介绍 


Ши 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 7 章 \ 手 势 识 别 技术 介绍 .avi 
对 于 触摸 屏 设 备 来 说 ， 其 消息 传递 机 制 包括 按 下 、 抬 起 和 移动 这 几 种 ， 用 户 只 需要 简单 地 实现 本 
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4k onTouch 或 者 设置 触摸 监听 器 setOnTouchListener 即 可 处 理 触 摸 事 件 。 但 是 有 时 为 了 提高 应 用 程序 的 
用 户 体验 ， 需 要 识别 用 户 当前 正在 操作 的 手势 。 本 节 将 详细 讲解 在 Android 设备 中 实现 手势 识别 的 基 


本 知识 。 
7.2.1 手势 识别 类 GestureDetector 


在 Android 系统 中 ， 专 门 提供 了 手势 识别 类 GestureDetector。 在 Android 设备 中 ， 通 过 类 
GestureDetector 可 以 识别 很 多 的 手势 ， 通 过 其 nTouchEvent(event) 方 法 可 以 完成 不 同 手势 的 识别 。 类 
GestureDetector 对 外 提供 了 两 个 接口 : OnGestureListener 和 OnDoubleTapListener， 另 外 还 提供 了 一 个 


内 部 类 SimpleOnGestureListener。 


(1) GestureDetectorOnDoubleTapListener 接口 : 用 来 通知 DoubleTap 事件 ， 类 似 于 鼠标 的 双击 事 
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件 。 此 接口 中 各 个 成 员 的 具体 说 明 如 下 所 示 。 


onDoubleTap(MotionEvent е): 在 二 次 双击 Touch down 时 触发 。 
onDoubleTapEvent(MotionEvent e): 通知 DoubleTap 手势 中 的 事件 ， 包 含 down、up 和 move 
事件 (这 里 指 的 是 在 双击 之 间 发 生 的 事件 ， 例 如 在 同一 个 地 方 双 击 会 产生 DoubleTap FH, 
而 在 DoubleTap 手势 里 面 还 会 发 生 down 和 up 事件 , 这 两 个 事件 由 该 函数 通知 ); 双击 的 第 二 
下 Touch down 和 up 都 会 触发 ， 可 用 e.getAction0 区 分 。 

onSingleTapConfirmed(MotionEvent e): 用 来 判定 该 次 点 击 是 SingleTap 而 不 是 DoubleTap， 如 
果 连 续 点 击 两 次 就 是 DoubleTap 手势 ， 如 果 只 点 击 一 次 ， 系 统 等 待 一 段 时 间 后 没有 收 到 第 二 
次 点 击 则 判定 该 次 点 击 为 SingleTap 而 不 是 DoubleTap， 然 后 触发 SingleTapConfirmed 事件 。 
这 个 方法 不 同 于 onSingleTapUp, 它 是 在 GestureDetector 确信 用 户 在 第 一 次 触摸 屏幕 后 ,没有 
紧 跟着 第 二 次 触摸 屏幕 ， 也 就 是 不 是 “双击 ”时 触发 。 


(2) GestureDetector.OnGestureListener 接口 : 用 来 通知 普通 的 手势 事件 ， 该 接口 有 如 下 所 示 的 6 
个 回调 函数 。 


AARAA 


7.2.2 


onDown(MotionEvent e): down 事件 。 

onSingleTapUp(MotionEvent e): 一 次 点 击 up 事件 ， 在 touch down 后 没有 滑动 。 

onLongPress: 用 户 长 按 触 摸 屏 ， 由 多 个 MotionEvent ACTION_DOWN 触发。 

onShowPress(MotionEvent е): down 事件 发 生 而 move 或 up 还 没 发 生前 触发 该 事件 。 

onFling(MotionEvent el, MotionEvent e2, float velocityX, float velocityY): 滑动 手势 事件 , Touch 

了 滑动 一 点 距离 后 ， 在 ACTION UP 时 才 会 触发 。 各 个 参数 的 具体 说 明 如 下 所 示 。 

> el: 第 一 个 ACTION_ DOWN MotionEvent 并 且 只 有 一 个 。 

> е2: 最 后 一 个 ACTION_MOVE MotionEvent。 

> velocityX: X 轴 上 的 移动 速度 ， 像 素 / 秒 。 

>  velocityY: 立轴 上 的 移动 速度 ， 像 素 / 秒 ， 触 发 条 件 为 X 轴 的 坐标 位 移 大 于 FLING_MIN_ 
DISTANCE， 且 移动 速度 大 于 FLING MIN VELOCITY 个 像素 / 秒 。 

onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY): 在 屏幕 上 拖 动 事件 。 

无 论 是 用 手 拖 动 view， 或 者 是 以 抛 的 动作 滚动 ， 都 会 多 次 触发 。 这 个 方法 在 ACTION MOVE 

动作 发 生 时 就 会 触发 。 


手势 检测 器 类 GestureDetector 


Android 系统 的 事件 处 理 机 制 是 基于 Listener (监听 器 ) 实现 的 ， 和 触摸 屏 相 关 的 事件 是 通过 
onTouchListener 实现 的 .另外 ,在 Android 系统 中 ,所 有 类 View 的 子 类 都 可 以 通过 setOnTouchListenerO、 
setOnKeyListener() 等 方法 来 添加 对 某 一 类 事件 的 监听 器 。 并 且 Listener 一 般 会 以 Interface GZO) 的 方 
式 来 提供 , 其 中 包含 一 个 或 多 个 abstract (抽象 ) 方 法 , 我 们 需要 实现 这 些 方 法 来 完成 onTouch0、onKey0 


等 操作 。 


这 样 当 给 菜 个 View 设置 了 事件 Listener， 并 实现 了 其 中 的 抽象 方法 以 后 ， 程 序 便 可 以 在 特定 


的 事件 被 Dispatch (调用 〉 到 该 View 时 ， 通 过 callback 函数 给 予 对 应 的 响应 。 
在 Android 开发 应 用 中 ， 有 多 种 使 用 类 GestureDetector 的 方法 。 


1. 第 一 种 
C1) 通过 GestureDetector 的 构造 方法 将 SimpleOnGestureListener 对 象 传递 进去 ， 这 样 


@ 
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GestureDetector 就 能 处 理 不 同 的 手势 。 


public GestureDetector(Context context, GestureDetector.OnGestureListener listener) 


(2) 在 onTouch() 方 法 中 实现 OnTouchListener 监听 ， 代 码 如 下 : 
private OnTouchListener gestureTouchListener = new OnTouchListener() { 
public boolean onTouch(View v, MotionEvent event) { 
return gDetector.onTouchEvent(event); 


ү 
2. 第 二 种 
(1) 使 用 如 下 所 示 的 方法 构建 场景 : 


private GestureDetector mGestureDetector; 
mGestureListener = new BookOnGestureListener(); 

(2) 使 用 new 新 建构 造 出 来 的 GestureDetector XJ R: 
mGestureDetector = new GestureDetector(mGestureListener); 
class BookOnGestureListener implements OnGestureListener { 

(3) 实现 事件 处 理 : 
public boolean onTouchEvent(MotionEvent event) { 

mGestureListener.onTouchEvent(event); 


} 
з. 第 三 种 


(1) 在 当前 类 中 创建 一 个 GestureDetector 实例 。 
private GestureDetector mGestureDetector; 
(2) 创建 一 个 Listener 来 实时 监听 当前 面板 操作 手势 。 
class LearnGestureListener extends GestureDetector.SimpleOnGestureListener 
(3) 在 初始 化 时 ， 将 Listener 实例 关联 当前 的 GestureDetector 实例 。 
mGestureDetector = new GestureDetector(this, new LearnGestureListener()); 
(4) 使 用 方法 onTouchEvent0 作 为 入 口 检测 ， 通 过 传递 MotionEvent 参数 来 监听 操作 手势 。 
mGestureDetector.onTouchEvent(event) 
例如 下 面 的 演示 代码 : 
private GestureDetector mGestureDetector; 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedinstanceState); 
mGestureDetector = new GestureDetector(this, new LearnGestureListener()); 
} 
@Override 
public boolean onTouchEvent(MotionEvent event) { 
if (mGestureDetector.onTouchEvent(event)) 


return true; 
else 
return false; 
) 
class LearnGestureListener extends GestureDetector.SimpleOnGestureListener{ 
@Override 


public boolean onSingleTapUp(MotionEvent ev) ( 


Ge 
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Log.d("onSingleTapUp",ev.toString()); 
return true; 

} 

@Override 

public void onShowPress(MotionEvent ev) { 
Log.d("onShowPress" ev.toString()); 

} 

@Override 

public void onLongPress(MotionEvent ev) { 
Log.d("onLongPress",ev.toString()); 

} 

@Override 

public boolean onScroll(MotionEvent e1, MotionEvent е2, float distanceX, float distanceY) { 
Log.d("onScroll",e1 .toString()); 
return true; 

} 

@Override 

public boolean onDown(MotionEvent ev) { 
Log.d("onDownd'" ev.toString()); 
return true; 

} 

@Override 

public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) ( 
Log.d("d" e1.toString()); 
Log.d("e2" e2.toString()); 
return true; 


) 
4. 第 四 种 


(1) 创建 一 个 GestureDetector 的 对 象 ， 传 入 listener 对 象 ， 在 接收 到 的 onTouchEvent 中 将 event 
传 给 GestureDetector HEAT HT, listener 会 回调 给 相应 的 动作 。 

(2) 通过 GestureDetector.SimpleOnGestureListener (Framework 帮 我 们 简化 了 ) 实现 了 OnGesture 
Listener 和 OnDoubleTapListener 两 个 接口 类 ， 只 需要 继承 它 并 重 写 其 中 的 回调 即 可 。 

(3) 设 置 在 第 一 次 点 击 down 时 , 给 Hanlder 发 送 一 个 延 时 的 消息 , 例如 延 时 300ms. 如 果 在 300ms 
中 发 生 了 第 二 次 点 击 的 down 事件 ， 那 么 就 认为 是 双击 事件 ， 并 移 除 之 前 发 送 的 延 时 消息 。 如 果 300ms 
后 仍 没 有 第 二 次 的 down 消息 ， 那 么 就 判定 为 SingleTapConfirmed 事件 (当然 ， 此 时 用 户 的 手指 应 已 完 
成 第 一 次 点 击 的 up 过 程 )。 第 三 次 点 击 的 判定 和 双击 的 判定 类 似 ， 只 是 多 了 一 次 发 送 延 时 消息 的 过 程 。 

例如 下 面 的 演示 代码 : 

private GestureDetector mGestureDetector; 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
mGestureDetector = new GestureDetector(this, new MyGestureListener()); 


} 
@Override 
public boolean onTouchEvent(MotionEvent event) { 
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return mGestureDetector.onTouchEvent(event); 


} 
class MyGestureListener extends GestureDetector.SimpleOnGestureListener{ 
@Override 
public boolean onSingleTapUp(MotionEvent ev) { 
Log.d("onSingleTapUp" ev.toString()); 
return true; 


} 

@Override 

public void onShowPress(MotionEvent ev) { 
Log.d("onShowPress",ev.toString()); 

} 


@Override 
public void onLongPress(MotionEvent ev) { 
Log.d("onLongPress",ev.toString()); 
} 
} 
723 手势 识别 处 理事 件 和 方法 


在 Android 系统 中 实现 手势 识别 功能 时 ， 通 常 通过 如 下 所 示 id 事件 和 方法 实现 。 
(1) boolean onDoubleTap(MotionEvent е): 双击 的 第 二 下 Touch down 时 触发 。 
(2) boolean onDoubleTapEvent(MotionEvent e): 双击 的 第 二 下 Touch down 和 up 都 会 触发 ， 可 用 
e.getAction()[X 4) o 
(3) boolean onDown(MotionEvent e): Touch down 时 触发 。 
(4) boolean onFling(MotionEvent el, MotionEvent е2, float velocityX, float velocityY): Touch J tit 
动 一 点 距离 后 ，up 时 触发 。 
(5) void onLongPress(MotionEvent e): Touch 了 不 移动 一 直 Touch down 时 触发 。 
(6) boolean onScroll(MotionEvent el, MotionEvent е2, float distanceX, float distanceY): Touch 了 滑 
动 时 触发 。 
(7) void onShowPress(MotionEvent е): Touch 了 还 没有 滑动 时 触发 。 
注意 : onDown 和 onLongPress 的 具体 对 比如 下 所 示 。 
回 onDown 只 要 Touch down 一 定 立 刻 触发 。 
而 Touch down 后 过 一 会 儿 没 有 滑动 先 触 发 onShowPress 再 触发 onLongPress。 


由 此 可 见 ，Touch down 后 一 直 不 滑动 ， 会 按照 onDown—onShowPress>onLongPress 的 顺序 进行 
触发 。 
(8) boolean onSingleTapConfirmed(MotionEvent e) 和 boolean onSingleTapUp(MotionEvent e): 这 两 
个 函数 都 是 在 Touch down 后 又 没有 滑动 (onScroll)， 又 没有 长 按 (onLongPress), 然后 Touch up 时 触发 。 
(9) onDown-onSingleTapUp—onSingleTapConfirmed: 点 击 一 下 非常 快 的 (不 滑动 )Touch up. 
(10) onDown 一 onShowPress 一 onSingleTapUp 一 onSingleTapConfirmed: 点 击 一 下 稍微 慢 点 的 (不 
滑动 ) Touch up. 
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73 ”实战 演练 一 一 通过 点 击 的 方式 移动 图 片 


EM 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 7 章 \ 通 过 点 击 的 方式 移动 图 片 .avi 

在 触摸 屏 手机 中 ， 点 击 移动 照片 的 功能 十 分 常见 。 在 本 实例 用 Image View 控件 来 显示 Drawable 中 
的 照片 ， 在 程序 运行 后 将 照片 放 在 屏幕 中 央 。 通 过 onTouchEvent 来 处 理 点 击 、 拖 动 、 放 开 等 事件 来 完 
成 拖 动 图 片 的 功能 。 并 且 设置 了 ImageView 的 点 击 监听 事件 ， 让 用 户 在 点 击 图 片 的 同时 恢复 到 图 片 的 
初始 位 置 。 本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 讲 解 在 Android 屏幕 中 通过 点 击 的 方式 移动 图 片 的 
方法 和 具体 实现 流程 。 


编写 主 程序 文件 example162.java， 具 体 实现 流程 如 下 所 示 。 
(1) 通过 DisplayMetrics 获取 屏幕 对 象 ， 分 别 用 intScreenX 和 intScreenY 取得 屏幕 解析 像素 并 分 
别 设置 图 片 的 宽 和 高 。 具 体 代码 如 下 : 
public void onCreate(Bundle savedinstanceState) 
{ 


super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


PS RRR) 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(dm); 


PHS BER) 
intScreenX = dm.widthPixels; 
intScreenY = dm.heightPixels; 


”设置 图 片 的 宽 和 高 "/ 

intWidth = 100; 

intHeight = 100; 

(2) 将 图 片 从 Drawable 中 赋值 给 ImageView 控件 来 呈现 在 屏幕 中 ， 并 通过 方法 RestoreButton() 
初始 化 按钮 使 其 位 置 居中 。 有 具体 代码 如 下 : 

/* 通 过 findViewByld 构造 器 创建 ImageView 对 象 %/ 
mlmageView01 =(ImageView) findViewByld(R.id.mylmageView1); 
Г Н А Drawable 赋值 给 ImageView 来 呈现 */ 
mlmageView01.setlmageResource(R.drawable.baby); 


”初始 化 按钮 位 置 居中 */ 
RestoreButton(); 
G) 定义 点 击 监听 事件 setOnClickListener, 74 P ili Image View 图 片 时 将 图 片 还 原 到 初始 位 置 
显示 。 具 体 代码 如 下 : 
/* 当 点 击 ImageView， 还 原初 始 位 置 */ 
mimageView01.setOnClickListener(new Button.OnClickListener() 
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{ 
@Override 
public void onClick(View v) 


RestoreButton(); 
} 
» 
) 
(4) 定义 onTouchEvent(MotionEvent еуеш) пй S(t. HARIS РУНИ BERE. MAIS 
实现 触 控 事件 的 处 理 ， 分 别 实现 点 击 屏幕 、 移 动 位 置 和 离开 屏幕 这 3 个 动作 处 理 。 具 体 代 码 如 下 : 
/* 覆 盖 触 控 事件 */ 
public boolean onTouchEvent(MotionEvent event) 


fe 
人 * 取 得 手指 触 控 屏 幕 的 位 置 */ 
float x = event.getX(); 
float y = event.getY(); 


try 


A* 触 控 事件 的 处 理 */ 
switch (event.getAction()) 


{ 
人 * 点 击 屏幕 */ 
case MotionEvent.ACTION_DOWN: 
picMove(x, y); 
break; 
Baie") 
case MotionEvent.ACTION_MOVE: 
picMove(x, y); 
break; 
FRR) 
case MotionEvent.ACTION_UP: 
picMove(x, y); 
break; 


} 
}catch(Exception e) 
{ 


e.printStackTrace(); 


} 
return true; 
} 
(5) 定义 方法 picMove(float х, float y) 来 移动 屏幕 中 的 图 片 ， 具 体 代码 如 下 : 
A 移动 图 片 的 方法 */ 
private void picMove(float x, float у) 


{ 
SRR Siete 
mX=x-(intWidth/2); 
mY=y-(intHeight/2); 


/防止 图 片 超过 屏幕 的 相关 处 理 "/ 
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A* 防 止 屏幕 向 右 超过 屏幕 */ 
if((mX+intWidth)>intScreenX) 


{ 
mX = intScreenX-intWidth; 


| 
A* 防 止 屏幕 向 左 超过 屏幕 */ 
else if(mX<0) 


} 
A* 防 止 屏幕 向 下 超过 屏幕 */ 
else if ((mY+intHeight)>intScreenY) 


mY-intScreenY-intHeight; 


} 
”防止 屏幕 向 上 超过 屏幕 */ 
else if (mY<0) 


} 

/通过 log 来 查看 图 片 位 置 */ 

Log.i("jay", Float.toString(mX)+","+Float.toString(mY)); 
/以 setLayoutParams() 方 法 ， 重 新 安排 Layout 上 的 位 置 */ 
mlmageView01.setLayoutParams 


new AbsoluteLayout.LayoutParams 

(intWidth,intHeight, (int) mX, (int)mY) 
y 
) 
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(6) 定义 方法 RestoreButton0 来 还 原 ImageView 图 片 到 初始 位 置 ， 具 体 代 码 如 下 : 


/还 原 ImageView 位 置 的 事件 处 理 */ 
public void RestoreButton() 
{ 
intDefaultX = ((intScreenX-intWidth)/2); 
intDefaultY = ((intScreenY-intHeight)/2); 
/Toast 还 原 位 置 坐 标 */ 
mMakeTextToast 
( 
(+ 
Integer.toString(intDefaultX)+ 
DE 


Integer.toString(intDefaultY )+")" true 
y 


让 以 setLayoutParams() 方 法 ， 重 新 安排 Layout 上 的 位 置 */ 
mimageView01.setLayoutParams 
( 
new AbsoluteLayout.LayoutParams 
(intWidth,intHeight,intDefaultX, intDefaultY ) 
k 
} 
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执行 后 效果 如 图 7-2 所 示 ， 可 以 通过 鼠标 点 击 的 方式 移动 图 片 的 位 置 ， 如 图 7-3 所 示 。 


图 7-2 执行 效果 图 7-3 移动 图 片 


74 ”实战 演练 一 一 实现 各 种 手势 识别 


Ши 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 7 章 \ 实 现 各 种 手势 识别 .avi 
本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 讲 解 在 Android 系统 中 实现 各 种 常见 手势 识别 的 方法 和 具 
体 实 现 流程 。 


га B 功 能 源码 路 径 
:实例 7-2 .在 屏幕 中 实现 各 种 常见 的 手势 识别 “光盘:\daimaN\GestueEX — ; 


7.4.1 布局 文件 main.xml 


布局 文件 main.xml 非常 简单 ， 具 体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="Vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/hello" 
> 

</LinearLayout> 


7.4.2 ”隐藏 屏幕 项 部 的 电池 等 图 标 和 标题 内 容 


XE Activity 的 实现 文件 是 mainActivityjava， 功 能 是 为 了 更 好 地 演示 手势 识别 效果 ， 将 屏幕 项 部 的 
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电池 等 图 标 和 标题 内 容 隐藏 。 文 件 mainActivityjava 的 具体 实现 代码 如 下 : 
public class mainActivity extends Activity{ 
private GestureDetector mGestureDetector;; 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlInstanceState); 
mGestureDetector = new GestureDetector(this, new MyGestureListener()); 


if(getRequestedOrientation()!-ActivitylInfo.SCREEN ORIENTATION LANDSCAPE) 
setRequestedOrientation(ActivityInfo.SCREEN ORIENTATION LANDSCAPE); 
} 


this.getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager. 
LayoutParams.FLAG_FULLSCREEN); 

/ 隐 去 电池 等 图 标 和 一 切 修饰 部 分 〈 状 态 栏 部 分 ) 

this.requestWindowFeature(Window.FEATURE NO TITLE); 

/ 隐 去 标题 栏 程序 的 名 字 ) 

setContentView(new MyView(this)); 


} 


@Override 
public boolean onTouchEvent(MotionEvent event) { 
if (mGestureDetector.onTouchEvent(event)) 
return true; 
else 
return false; 


) 
743 监听 触摸 屏幕 中 各 种 常用 的 手势 


编写 文件 MyGestureListenerjava， 功 能 是 监听 触摸 屏幕 中 各 种 常用 的 手势 ， 具 体 实现 代码 如 下 : 
public class MyGestureListener extends SimpleOnGestureListener implements 
OnGestureListener { 
@Override 
public boolean onDoubleTap(MotionEvent e) { 
MyView.x=e.getX(); 
MyView.y=e.getY(); 
return super.onDoubleTap(e); 
} 
@Override 
public boolean onDoubleTapEvent(MotionEvent e) { 
MyView.x=e.getX(); 
MyView.y-e.getY(); 
return super.onDoubleTapEvent(e); 
} 
@Override 
public boolean onDown(MotionEvent e) { 
MyView.x=e.getX(); 
MyView.y-e.getY(); 
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return super.onDown(e); 
| 
@Override 
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, 
float velocityY) ( 
MyView.x-e2.getX(); 
MyView.y=e2.getY(); 
return super.onFling(e1, e2, velocityX, velocityY); 
} 
@Override 
public void onLongPress(MotionEvent e) { 
MyView.x=e.getX(); 
MyView.y=e.getY (); 
super.onLongPress(e); 
} 
@Override 
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, 
float distanceY) { 
MyView.x=e2.getX(); 
MyView.y=e2.getY (); 
return super.onScroll(e1, е2, distanceX, distanceY); 
} 
@Override 
public void onShowPress(MotionEvent e) { 
super.onShowPress(e); 
} 
@Override 
public boolean onSingleTapConfirmed(MotionEvent e) { 
MyView.x=e.getX(); 
MyView.y=e.getY (); 
return super.onSingleTapConfirmed(e); 
} 
@Override 
public boolean onSingleTapUp(MotionEvent e) { 
return super.onSingleTapUp(e); 
} 
} 


744 根据 监听 到 的 用 户 手 势 创 建 视图 


编写 文件 MyViewjava， 功 能 是 根据 监听 到 的 用 户 手势 创建 不 同 的 视图 。 文 件 MyView.java 的 具体 
实现 代码 如 下 : 
public class MyView extends SurfaceView implements SurfaceHolder.Callback { 
SurfaceHolder holder; 
static float x; 
static float у; 
public MyView(Context context) { 
super(context); 
holder = this.getHolder();//3& HX holder 
holder.addCallback(this); 
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} 


@Override 
public void surfaceChanged(SurfaceHolder holder, int format, int width, 
int height) { 


} 


@Override 

public void surfaceCreated(SurfaceHolder holder) { 
new Thread(new MyThread()).start(); 

} 


@Override 
public void surfaceDestroyed(SurfaceHolder holder) { 


} 
public class MyThread implements Runnable { 
Paint paint=new Paint(); 
@Override 
public void run() { 
while(true){ 
Canvas canvas = holder.lockCanvas(null);//3& REA 
paint.setColor(Color.BLACK); 
canvas.drawRect(0, 0, 320, 480, paint); // 竖 屏 
canvas.drawRect(0, 0, 480, 320, paint); 
paint.setColor(Color. GREEN); 
canvas.drawRect(x-5, y-5, x+5, y+5, paint); 


holder.unlockCanvasAndPost(canvas);// 解 锁 画 布 ， 提 交 画 好 的 图 像 
try{ 

Thread.sleep(100); 
} catch (InterruptedException e) { 

e.printStackTrace(); 


} 


} 


至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 7-4 所 示 。 在 真 机 中 运行 后 ， 会 实现 手势 识别 功能 。 


Ri 


74 执行 效果 
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ERU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 7 章 \ 实 现 手 势 翻 页 效果 .avi 
本 节 将 通过 一 个 具体 实例 的 实现 过 程 ， 讲 解 在 Android 系统 中 实现 手势 翻 页 效果 的 方法 和 具体 实 
现 流程 。 


7.5.1 布局 文件 main.xml 


布局 文件 main.xml 非常 简单 ， 具 体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android” 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/hello" 
> 
</LinearLayout> 


752 监听 手势 


编写 程序 文件 MyViewGroup.java, 根据 用 户 触摸 屏幕 的 操作 来 响应 手势 , 通过 ViewFlipper 变化 当 
前 的 显示 内 容 ， 通 过 GestureDetector 监听 手势 实现 多 页 滑动 展示 效果 。 文件 MyViewGroup.java 的 具体 
实现 代码 如 下 : 


public class MyViewGroup extends ViewGroup implements OnGestureListener { 


private float mLastMotionY;// 最 后 点 击 的 点 

private GestureDetector detector; 

int move = 0;// 移 动 距离 

int MAXMOVE = 850;// 最 大 允许 的 移动 距离 

private Scroller mScroller; 

intup excess move = 0;// 往 上 多 移 的 距离 

int down_excess_move = 0;// 往 下 多 移 的 距离 
private final static int TOUCH_STATE_REST = 0; 
private final static int TOUCH_STATE_SCROLLING = 1; 
private int mTouchSlop; 

private int mTouchState = TOUCH_STATE_REST; 
Context mContext; 
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public MyViewGroup(Context context) { 
super(context); 
mContext = context; 
setBackgroundResource(R.drawable.pic); 
mScroller = new Scroller(context); 
detector = new GestureDetector(this); 


final ViewConfiguration configuration = ViewConfiguration.get(context); 
// 获 得 可 以 认为 是 滚动 的 距离 
mTouchSlop = configuration.getScaledTouchSlop(); 


// 添 加 子 View 

for (int i = 0;i < 48; i++) { 
final Button MButton = new Button(context); 
MButton.setText(" + (i + 1)); 
MButton.setOnClickListener(new OnClickListener() { 


public void onClick(View v) { 


Toast.makeText(mContext, MButton.getText(), Toast.LENGTH SHORT).show(); 


) 
ys; 
addView(MButton); 


} 


@Override 
public void computeScroll() { 
if (mScroller.computeScrollOffset()) ( 
// 返 回 当前 滚动 X 方向 的 偏 移 
scrollTo(0, mScroller.getCurrY()); 
postinvalidate(); 


} 


@Override 
public boolean onInterceptTouchEvent(MotionEvent ev) { 
final int action = ev.getAction(); 


final float y = ev.getY(); 
switch (ev.getAction()) 


{ 
case MotionEvent.ACTION_DOWN: 


mLastMotionY = y; 
mTouchState = mScroller.isFinished() ? TOUCH STATE REST 
: TOUCH STATE SCROLLING; 
break; 
case MotionEvent. ACTION MOVE: 
final int yDiff = (int) Math.abs(y - mLastMotionY); 
boolean yMoved = yDiff > mTouchSlop; 
// 判 断 是 否 是 移动 
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if (yMoved) { 
mTouchState = TOUCH_STATE_SCROLLING; 
} 
break; 
case MotionEvent.ACTION_UP: 
mTouchState = TOUCH_STATE_REST; 


break; 
} 
return mTouchState = TOUCH STATE REST; 
} 
@Override 


public boolean onTouchEvent(MotionEvent ev) { 
JI final int action = ev.getAction(); 


final float y = ev.getY(); 
switch (ev.getAction()) 


case MotionEvent.ACTION_DOWN: 
if (ImScroller.isFinished()) { 
mScroller.forceFinished(true); 
move = mScroller.getFinalY(); 


mLastMotionY = y; 
break; 

case MotionEvent.ACTION MOVE: 
if (ev.getPointerCount() == 1) ( 


// 随 手指 拖 动 的 代码 
int deltaY = 0; 
deltaY = (int) (mLastMotionY - у); 
mLastMotionY = y; 
Log.d("move", "" + move); 
if (deltaY < 0) { 

/下 移 

// 判 断 上 移 是 否 滑 过 头 

if (up_excess_move == 0) { 

if (move > 0) { 
int move_this = Math.max(-move, deltaY); 
move = move + move_this; 
scrollBy(0, move this); 

} else if (move == 0) {// 如 果 已 经 是 最 顶端 ， 继 续 往 下 拉 
Log.d("down_excess_move", "" + down excess move); 
down_excess_move = down_excess_move - deltaY / 2;// 记 录 下 多 往 下 拉 

的 值 
scrollBy(0, deltaY / 2); 


} 
} else if (up excess move > 0)// 之 前 有 上 移 过 头 
{ 


if (up_excess_move >= (-deltaY)) { 
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up_excess_move = up_excess_move + deltaY; 
scrollBy(0, deltaY); 
) else { 
up_excess_move = 0; 
ScrollBy(0, -up_excess_move); 
} 
} 
} else if (deltaY > 0) { 
NEB 
if (down_excess_move == 0) { 
if (MAXMOVE - move > 0) { 
int move_this = Math.min(MAXMOVE - move, deltaY); 
move = move + move_this; 
scrollBy(0, move this); 
} else if (MAXMOVE - move == 0) { 
if (up_excess_move <= 100) { 
up_excess_move = up_excess_move + deltaY / 2; 
scrollBy(0, deltaY / 2); 
} 


} else if (down_excess_move > 0) { 
if (down_excess_move >= deltaY) { 
down_excess_move = down_excess_move - deltaY; 
scrollBy(0, deltaY); 
) else { 
down_excess_move = 0; 
scrollBy(0, down_excess_move); 


) 

) 

break; 

case MotionEvent.ACTION_UP: 

// 多 滚 是 负数 记录 到 move 中 

if (up_excess_move > 0){ 
// 多 滚 了 要 弹 回去 
scrollBy(0, -up_excess_move); 
invalidate(); 
up_excess_move = 0; 

1 

if (down_excess_move > 0) { 
// 多 滚 了 要 弹 回去 
scrollBy(0, down_excess_move); 
invalidate(); 
down_excess_move = 0; 

} 

mTouchState = TOUCH_STATE_REST; 

break; 

} 


return this.detector.onTouchEvent(ev); 
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int Fling_move = 0; 


public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, 
float velocityY) ( 
/随手 指 快速 拨 动 的 代码 
Log.d("onFling", "onFling"); 
if (up excess move == 0 && down excess move == 0) { 


int slow = -(int) velocityY * 3 / 4; 

mScroller.fling(0, move, 0, slow, 0, 0, 0, MAXMOVE); 
move = mScroller.getFinalY(); 

computeScroll(); 


return false; 


} 


public boolean onDown(MotionEvent e) { 
return true; 


} 


public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, 
float distanceY) { 
return false; 


} 


public void onShowPress(MotionEvent e) { 


} 


public boolean onSingleTapUp(MotionEvent e) { 
return false; 


} 


public void onLongPress(MotionEvent e) { 


} 


@Override 
protected void onLayout(boolean changed, int |, int t, int r, int b) ( 
int childTop 7 0; 
int childLeft = 0; 
final int count = getChildCount(); 
for (int i = 0; i < count; i++) ( 
final View child = getChildAt(i); 
if (child.getVisibility() = View. GONE) { 
child.setVisibility(View. VISIBLE); 
child.measure(r - |, b - t); 
child 
-layout(childLeft, childTop, childLeft + 80, 
childTop + 80); 
if (childLeft < 160) { 
childLeft += 80; 
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) else { 
childLeft = 0; 
childTop += 80; 
| 
} 
} 
} 
} 
执行 之 后 将 实现 翻 页 效果 ， 如 图 7-5 所 示 。 
MoveViewGroup 
1 2 3 
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图 7-5 执行 效果 


手势 识别 实战 


第 8 章 在 物 联网 设备 中 处 理 多 媒体 数据 


从 Android 2.2 版 本 以 后 , Android 对 多 媒体 框架 进行 了 很 大 的 调整 , 抛弃 了 原来 的 OpenCore 框架 ， 
HUH StageFright 框架 。 和 OpenCore 框架 相 比 ，StageFright 框架 的 最 突出 优点 是 封装 简单 ， 功 能 强大 。 
在 Android 2.2 及 以 前 ，OpenCore 位 于 external 目录 下 ， 在 Android 2.3 以 后 ， 多 媒体 的 功能 被 放置 到 
frameworks/base/media 目录 下 。 本 章 将 详细 讲解 OpenCore 框架 和 StageFright 框架 的 基本 知识 ， 详 细 讲 
解 在 Android 物 联网 设备 中 播放 音乐 、 录 制 声音 、 实 现 振动 、 设 置 铃 音 的 方法 。 


8.1 Android 多 媒体 系统 架构 基础 


Gl 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 8 章 \Android 多 媒体 系统 架构 基础 .avi 
Android 多 媒体 引擎 和 插件 的 基本 层次 结构 如 图 8-1 所 示 。 


Android 媒 体 应 用 
+ 平台 API 
Java 框 架 
Media 的 Java 类 
本 地 框架 
Media JNI 和 Media 本 地 框架 库 
UO 插件 OpenCore Stagefright 其 他 引擎 
Android 系 统 
yp ҷу 
Codec 驱 动 硬件 和 驱动 


8-1 Android 多 媒体 引擎 和 插件 的 基本 层次 


Android 系统 的 多 媒体 框架 结构 如 图 8-2 所 示 。 
从 多 媒体 应 用 的 实现 角度 来 看 ， 多 媒体 系统 主要 包含 如 下 两 方面 的 内 容 。 
(1) 输入 、 输 出 环节 : 音频 、 视 频 纯 数据 流 的 输入 、 输 出 系统 。 
(2) 中 间 处 理 环节 : 包括 文件 格式 处 理 和 编码 /解码 环节 处 理 。 
假如 想 要 处 理 一 个 MP3 文件 ， 媒 体 播放 器 的 处 理 流程 是 : 将 一 个 MP3 格式 的 文件 作为 播放 器 的 
输入 ， 将 声音 从 播放 器 设备 输出 。 在 具体 实现 上 ，MP3 播放 器 经 过 了 MP3 格式 文件 解析 、MP3 码 流 
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解码 和 PCM 输出 播放 的 过 程 。 整 个 过 程 如 图 8-3 所 示 。 


Java Class of Media 
Java 框架 


Media JNI 


Media API 


| ees | 
IMediPlye | 


8-3 MP3 播放 器 结构 


8.1.1 OpenMax 框架 介绍 


OpenMax 是 NVIDIA 公司 和 Khronos 在 2006 年 联合 推出 的 产品 ,是 一 款 多 媒体 应 用 程序 的 框架 标 
准 。OpenMax 通过 使 用 媒体 加 速 组 件 ， 能 够 在 开发 、 集 成 和 编程 环节 中 实现 跨 多 操作 系统 和 处 理 器 硬 
件 平台 ， 提 供 了 全 面 的 流 媒体 编码 /解码 器 功能 和 应 用 程序 便携 化 处 理 。 

OpenMax 的 官方 网 站 地 址 是 http://www.khronos.org/openmax/。 

OpenMax 是 一 个 多 媒体 应 用 程序 的 框架 标准 。 其 中 ，OpenMax IL (RRE) 技术 规格 定义 了 媒体 
组 件 接口 ， 以 便 在 嵌入 式 器 件 的 流 媒 体 框架 中 快速 集成 加 速 编码 /解码 器 。 

在 Android 中 ，OpenMax IL 层 通常 被 用 在 多 媒体 引擎 插件 中 ，Android 的 多 媒体 引擎 OpenCore 和 
StageFright 都 可 以 使 用 OpenMax 作为 插件 ， 主 要 用 于 编码 和 解码 (Codec〉 处 理 。 

在 Android 的 框架 层 中 定义 了 由 Android 封装 的 OpenMax 接口 ， 此 接口 和 标准 的 接口 类 似 ,但 是 
使 用 的 是 C++ 类 型 接口 ， 并 且 使 用 了 Android 的 Binder IPC 机 制 。StageFright 使 用 Android 封装 的 
OpenMax 接口 ，OpenCore 没有 使 用 此 接口 ， 而 是 使 用 其 他 形式 对 OpenMax IL 层 接口 进行 封装 。 

Android 中 OpenMax 的 基本 层次 结构 如 图 8-4 所 示 。 
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标准 OpenMAX IL/Z 


d 


多 媒体 编码 /解码 硬件 和 驱动 


8-4 OpenMax 多 媒体 框架 的 层次 结构 
8.1.2 OpenCore 框架 介绍 


OpenCore 的 另外 一 个 常用 的 称呼 是 PacketVideo， 它 是 Android 的 多 媒体 核心 。 其 实 PacketVideo 
是 一 家 公司 的 名 称 ， 而 OpenCore 是 这 套 多 媒体 框架 的 软件 层 的 名 称 。OpenCore 和 其 他 Android 程序 
库 相 比 ，OpenCore 的 代码 十 分 庞大 ， 它 是 基于 C++ 实现 的 ， 在 里 面 定义 了 全 功能 的 操作 系统 移植 层 ， 
各 种 基本 的 功能 均 被 封装 成 类 的 形式 ， 各 层次 之 间 的 接口 多 使 用 继承 等 方式 。OpenCore 的 基本 结构 如 
图 8-5 所 示 。 


Android Media Framework 


FA 8-5 OpenCore 的 层次 结构 
OpenCore 是 一 个 多 媒体 的 框架 ， 主 要 包含 如 下 所 示 的 两 方面 内 容 。 
PVPlayer: 提供 了 媒体 播放 器 的 功能 ， 可 以 完成 各 种 音频 (Audio)、 视 频 (Video) 流 的 回放 
(Playback) 功能 。 
PVAuthor: 提供 媒体 流 记录 的 功能 ， 可 以 完成 各 种 音频 (Audio)、 视 频 (Video) 流 以 及 静态 
图 像 捕 获 功 能 。 


e. 
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PVPlayer 和 PVAuthor 以 SDK 的 形式 提供 给 开发 者 , 可 以 在 这 个 SDK 之 上 构建 多 种 应 用 程序 和 服 
务 。 在 移动 终端 中 常常 使 用 的 多 媒体 应 用 程序 ， 例 如 媒体 播放 器 、 照 相机 、 录 像 机 、 录 音 机 等 。 
在 图 8-5 所 示 的 结构 中 ， 主 要 层次 元 素 的 介绍 如 下 。 
(1) OSCL 
OSCL jÆ Operating System Compatibility Library 的 缩写 ， 意 为 操作 系统 兼容 库 ,， 在 里 面包 含 了 一 些 
操作 系统 底层 的 操作 ， 为 了 更 好 地 在 不 同 操作 系统 之 间 移 植 。 包 含 了 基本 数据 类 型 、 配 置 、 字 符 串 工 
具 、IO、 错 误 处 理 、 线 程 等 内 容 ， 类 似 一 个 基础 的 C++ 库 。 
(2) РУМЕ 
РУМЕ A Packet Video Multimedia Framework 的 缩写 ， 意 为 PV 多 媒体 框架 ， 可 以 在 框架 内 实现 一 
个 文件 解析 〈parser) 和 组 成 (composer)、 编 解码 的 NODE， 也 可 以 继承 其 通用 的 接口 ， 在 用 户 层 实 
现 一 些 NODE。 
(3) PVPlayer Engine 
PVPlayer Engine 是 PVPlayer 引擎 。 
(4) PVAuthor Engine 
PVAuthor Engine 是 PVAuthor 引擎 。 
PRY EIR 4 个 元 素 外 ， 其 实在 OpenCore 中 包含 的 内 容 还 有 很 多 。 从 播放 的 角度 看 ，PVPlayer 输入 
Йу (Source) 是 文件 或 者 网 络 媒体 流 ， 输 出 (Sink) 的 是 音频 /视频 的 输出 设备 ， 其 基本 功能 包含 了 媒 
体 流 控制 、 文 件 解析 、 音 频 / 视 频 流 的 解码 (Decode) 等 方面 的 内 容 。 除 了 从 文件 中 播放 媒体 文件 之 外 ， 
还 包含 了 与 网 络 相关 的 RTSP jii Real Time Stream Protocol, 实时 流 协议 )。 在 媒体 流 记录 方面 ,PVAuthor 
的 输入 〈Source) 是 照相 机 、 麦 克 风 等 设备 ， 输 出 〈Sink) 是 各 种 文件 ， 包含 了 流 的 同步 、 音 频 /视频 
流 的 编码 (Encode) 以 及 文件 的 写 入 等 功能 。 
在 使 用 OpenCore SDK 时 ， 有 可 能 需要 在 应 用 程序 层 实现 一 个 适配器 (Adaptor)， 然 后 在 适配器 上 
实现 具体 的 功能 ， 对 于 PVMF 的 NODE 也 可 以 基于 通用 的 接口 ， 在 上 层 实 现 ， 以 插件 的 形式 使 用 。 


8.1.3 StageFright 框架 介绍 


从 Android 2.0 开始 ，Google 开始 引入 了 架构 稍微 简单 的 StageFright, 并 且 从 Android 2.2 JF#ñ, JL 
乎 完全 放弃 了 OpenCore， 转 向 主推 StageFright。 
(1) StageFright 代码 结构 
StageFright 是 一 个 轻 量 级 的 多 媒体 框架 ， 其 主要 功能 是 基于 OpenMax 实现 的 。 在 StageFright 中 提 
供 了 媒体 播放 等 接口 ， 这 些 接口 可 以 为 Android 框架 层 所 使 用 。 
在 Android 开源 代码 中 ，StageFright 的 头 文件 路 径 是 frameworks/base/include/media/stagefright/. 
实现 StageFright 功能 的 文件 路 径 是 frameworks/base/media/libstagefright/ . 
实现 StageFright 播放 器 和 录音 器 功能 的 文件 路 径 是 frameworks/base/media/libmediaplayerservice/。 
测试 StageFright 功能 的 代码 路 径 是 fameworks/base/cmds/stagefright/。 
(2) StageFright 实现 OpenMax 接口 
StageFright 可 以 实现 Android 系统 中 的 OpenMax 接口 ， 可 以 让 StageFright 引擎 内 的 OMXCode 调 
用 实现 的 OpenMax 接口 ， 最 终 目的 是 使 用 OpenMax IL 编码 /解码 功能 。 
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类 Graphics 是 一 个 全 能 的 绘图 类 ， 不 但 可 以 绘制 2D 图 像 ， 而 且 可 以 轻松 地 为 这 些 图 像 填充 不 同 
的 颜色 。 为 什么 Graphics 这 么 强 呢 ? 原因 是 它 有 很 多 子 类 ， 通 过 这 些 子 类 可 以 实现 不 同 的 功能 。 本 节 
将 详细 讲解 在 Android 系统 中 使 用 Graphics 类 处 理 二 维 图 像 的 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 
打下 基础 。 


8.2.1 Graphics 类 基础 


在 类 Graphics 中 有 如 下 10 个 非常 重要 的 子 类 。 
M Color 类 

Paint Ж 

Canvas 画布 

Rect ЖЖЖ 
NinePatch 类 
Matrix 类 

Bitmap Ж 
BitmapFactory 类 
Typeface 类 
Shader Ж 


8.22 ”使 用 Graphics 类 
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在 Android 系统 中 ， 类 Rect 的 完整 形式 是 Android.Graphics.Rect, IREKE. Ж Rect 除了 能 
够 表示 一 个 矩形 区 域 位 置 描述 外 ， 还 可 以 帮助 计算 图 形 之 间 是 否 发 生 碰撞 关系 ， 这 一 点 对 于 Android 
游戏 开发 比较 有 用 。 在 类 Rect 的 方法 成 员 中 ， 主 要 通过 如 下 3 种 重 载 方法 来 判断 包含 关系 。 

boolean contains(int left, int top, int right, int bottom) 

boolean contains(int x, int y) 

boolean contains(Rect r) 


在 上 述 构造 方法 中 包含 了 4 个 参数 ， 即 left. top. right 和 bottom， 分 别 代表 左 、 上 、 右 、 下 4 个 
方向 ， 具 体 说 明 如 下 所 示 。 

Іей: 矩形 区 域 中 左边 的 XX 坐标 。 

top: 和 矩形 区 域 中 顶部 的 Y 坐标 。 

М right: JEJÉDOBUTUR GUI] X 坐标 。 

bottom: 和 矩形 区 域 中 底部 的 Y 坐标 。 

例如 下 面 代码 的 含义 是 ， 左 上 角 的 坐标 是 (150.75)， 右 下 角 的 坐标 是 (260,120)。 

Rect(150, 75, 260, 120) 


@ 
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在 Android 系统 中 ， 另 外 一 个 矩形 类 是 RectF， 此 类 和 类 Rect 的 用 法 几乎 完全 相同 。 两 者 的 区 别 
是 精度 不 一 样 ，Rect 是 使 用 int 类 型 作为 数值 ，RectF 是 使 用 float 类 型 作为 数值 。 在 类 RectF 中 包含 了 
一 个 矩形 的 4 个 单 精度 浮 点 坐标 ， 通 过 上 、 下 、 左 、 右 4 个 边 的 坐标 来 表示 一 个 矩形 。 这 些 坐 标 值 属 
性 可 以 被 直接 访问 ， 使 用 width 和 height 方法 可 以 获取 和 拢 形 的 宽 和 高 。 
类 Rect 和 类 RectF 提供 的 方法 也 不 是 完全 一 致 ， 类 RectF 提供 了 如 下 所 示 的 构造 方法 。 
RectF(: 功能 是 构造 一 个 无 参 的 矩形 。 
RectF(float left,float top,float right,float bottom): 功能 是 构造 一 个 指定 了 4 个 参数 的 矩形 。 
RectF(Rect F г): 功能 是 根据 指定 的 RectF 对 象 来 构造 一 个 RectF 对 象 ( 对 象 的 左边 坐标 不 变 )。 
RectF(Rect r): 功能 是 根据 给 定 的 Rect 对 象 来 构造 一 个 RectF WR. 
另外 在 类 RectF 中 还 提供 了 很 多 功能 强大 的 方法 ， 具 体 说 明 如 下 所 示 。 
Public Boolean contain(RectF г): 功能 是 判断 一 个 矩形 是 否 在 此 和 矩 形 内 ， 如 果 在 这 个 和 矩形 内 或 
者 和 这 个 矩形 等 价 则 返回 tue， 同 样 类 似 的 方法 还 有 public Boolean contain(float left,float 
top, float right,float bottom) 和 public Boolean contain(float x,float y). 
Public void union(float x,float у): 功能 是 更 新 这 个 矩形 ， 使 它 包含 矩形 自己 和 “(x,y)〉 这 个 点 。 
下 面 将 通过 一 个 具体 的 演示 实例 来 讲解 在 Android 中 使 用 Canvas 类 的 方法 。 
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x Fi x 能 | 源码 路 径 
GP 实例 8-1 — | fE Android 设备 中 使 用 矩形 类 Rect 和 RectF 光盘 \daima\8\RectEX — ; 
实例 文件 RectL.java 的 主要 实现 代码 如 下 : 
/声明 Paint 对 象 */ 


private Paint mPaint = null; 

private RectL_1 mGameView2 = null; 
public RectL(Context context) 
{ 


super(context); 
FEHR" 
mPaint = new Paint(); 


mGameView2 = new RectL_1(context); 


UF RR | 
new Thread(this).start(); 
} 


public void onDraw(Canvas canvas) 


{ 


super.onDraw(canvas); 


让 设置 画布 为 黑色 背景 '/ 
canvas.drawColor(Color.BLACK); 
PRE) 
mPaint.setAntiAlias(true); 


mPaint.setStyle(Paint.Style. STROKE); 
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Rect rect1 = new Rect(); 
MEERA 
rect1.left = 5; 

rect1.top = 5; 
rect1.bottom = 25; 
recti.right = 45; 


mPaint.setColor(Color.BLUE); 
ГАУ: 
canvas.drawRect(rect1, mPaint); 


mPaint.setColor(Color.RED); 
/绘制 矩形 
canvas.drawRect(50, 5, 90, 25, mPaint); 


mPaint.setColor(Color. YELLOW); 
"绘制 贺 形 (圆心 x, 圆心 y,3 ë r,p)*/ 
canvas.drawCircle(40, 70, 30, mPaint); 


"定义 椭圆 对 象 ”/ 

RectF rectf1 = new RectF(); 
AA) 

recti left = 80; 

rectf1.top = 30; 

rectf1.right = 120; 

rectf1 bottom = 70; 


mPaint.setColor(Color.LTGRAY); 
/绘制 椭圆 六 
canvas.drawOval(rectf1, mPaint); 


让 绘制 多 边 形 */ 
Path path1 = new Path(); 


RESCH ERI 
path1.moveTo(150+5, 80-50); 
path .lineTo(150+45, 80-50); 
path1 lineTo(150+30, 120-50); 
path1.lineTo(150420, 120-50); 
”使 这 些 点 构成 封闭 的 多 边 形 */ 
path1.close(); 


mPaint.setColor(Color. GRAY); 
让 绘制 这 个 多 边 形 */ 
canvas.drawPath(path1, mPaint); 


mPaint.setColor(Color.RED); 
mPaint.setStrokeWidth(3); 

"绘制 直线 */ 

canvas.drawLine(5, 110, 315, 110, mPaint); 
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} 

// 绘 制 实心 几何 体 

mPaint.setStyle(Paint.Style.FILL); 

{ 
EER) 
Rect rect1 = new Rect(); 
BER A 
rect1 Іей = 5; 
rect1.top = 130+5; 
rect1.bottom = 130+25; 
rect1.right = 45; 
mPaint.setColor(Color.BLUE); 
/绘制 矩形 六 
canvas.drawRect(rect1, mPaint); 


mPaint.setColor(Color.RED); 
/绘制 矩形 

canvas.drawRect(50, 130+5, 90, 130+25, mPaint); 
mPaint.setColor(Color. YELLOW); 
/绘制 圆 形 (圆心 x, 圆 心 y, 半 径 r,p)*/ 
canvas.drawCircle(40, 130+70, 30, тРаїпї); 
(EAT SC I 

RectF rectf1 = new RectF(); 
AA) 

recti left = 80; 

rectf1.top = 130+30; 

rectf1.right = 120; 

rectf1.bottom = 130+70; 
mPaint.setColor(Color.LTGRAY); 
T2880 E */ 
canvas.drawOval(rectf1, mPaint); 
"绘制 多 边 形 */ 

Path path1 = new Path(); 
RESCH sa"! 
path1.moveTo(150+5, 130+80-50); 
path1.lineTo(150+45, 130+80-50); 
path1.lineTo(150430, 130+120-50); 
path1.lineTo(150420, 130+120-50); 
/* 使 这 些 点 构成 封闭 的 多 边 形 */ 
path1.close(); 
mPaint.setColor(Color. GRAY); 

让 绘制 这 个 多 边 形 */ 
canvas.drawPath(path1, mPaint); 
mPaint.setColor(Color.RED); 
mPaint.setStrokeWidth(3); 

让 绘制 直线 */ 

canvas.drawLine(5, 130+110, 315, 130+110, mPaint); 


} 
/* 通 过 ShapeDrawable 来 绘制 几何 图 形 */ 
mGameView2.DrawShape(canvas); 


] 
// 触 笔 事件 
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public boolean onTouchEvent(MotionEvent event) 


{ 
return true; 
} 
/按键 按 下 事件 
public boolean onKeyDown(int keyCode, KeyEvent event) 
{ 
return true; 
} 
// 按 键 弹 起 事件 
public boolean onKeyUp(int keyCode, KeyEvent event) 
{ 
return false; 
} 
public boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event) 
{ 
return true; 
} 
public void run() 
{ 
while (!Thread.currentThread().isInterrupted()) 
{ 
try 
Thread.sleep(100); 
} 
catch (InterruptedException e) 
Thread.currentThread().interrupt(); 
} 
/使 用 postinvalidate 可 以 直接 在 线程 中 更 新 界面 
postinvalidate(); 
} 
} 


} 
执行 后 的 效果 如 图 8-6 所 示 。 


图 8-6 执行 效果 
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在 多 媒体 领域 中 ， 具 有 视觉 冲击 力 的 动画 是 程序 员 们 永远 谈论 的 话题 之 一 。 动 画 和 简单 的 图 像 相 
比 ， 更 具有 震撼 性 的 效果 。Android 提供 了 一 套 完整 的 动画 框架 ， 使 得 开发 者 可 以 用 它 来 开发 各 种 动画 
效果 。 


8.3.1 类 Drawable 


Android SDK 提供 了 一 个 功能 强大 的 类 一 一 Drawable， 虽 然 Drawable 是 一 个 很 抽象 的 概念 ， 但 是 
可 以 实现 动画 效果 。 市 面 中 有 很 多 知名 度 颇 高 的 动画 工具 ， 例 如 Flash， 并 且 在 手机 中 也 可 以 使 用 这 些 
工具 实现 动画 效果 。 但 是 身 为 Android 家 族 的 产品 ， 它 去 完成 和 动画 有 关 的 任务 ， 并 且 取得 的 效果 还 
不 错 。 就 这 样 久而久之 ，Drawable 深 受 开发 者 的 青睐 。 
为 了 深入 了 解 Drawable 的 基本 知识 ， 我 们 先 通过 一 个 简单 的 例子 来 认识 它 。 在 这 个 例子 中 ， 使 用 
Drawable 的 子 类 ShapeDrawable 绘制 一 幅 图 ， 具 体 实现 流程 如 下 : 
(1) 创建 一 个 OvalShape СІЯ). 
(2) 使 用 刚 创建 的 OvalShape 构造 一 个 ShapeDrawable 对 象 mDrawable。 
(3) 设置 mDrawable 的 颜色 。 
(4) 设置 mDrawable 的 大 小 。 
(5) 将 mDrawable 画 在 testViewCH 的 画布 上 。 
本 例 的 具体 代码 如 下 : 
public class testViewCH extends View { 
private ShapeDrawable mDrawable; 
public testViewCH(Context context) { 
super(context); 
int x = 10; 
int y = 10; 
int width = 300; 
int height = 50; 
mbDrawable = new ShapeDrawable(new OvalShape()); 
mDrawable.getPaint().setColor(Oxff74AC23); 
mDrawable.setBounds(x, y, x + width, у + height); 


protected void onDraw(Canvas canvas) 
super.onDraw(canvas); 
canvas.drawColor(Color. WHITE):// 画 白色 背景 
mDrawable.draw(canvas); 


} 
} 
上 述 代码 的 执行 效果 如 图 8-7 所 示 。 
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例子 虽然 简单 ， 但 是 却 让 我 们 明白 了 Drawable 就 是 一 个 可 画 的 对 象 ， 可 能 是 一 张 位 图 
(BitmapDrawable )， 也 可 能 是 一 个 图 形 (ShapeDrawable )， 还 有 可 能 是 一 个 图 层 (LayerDrawable)。 
在 项 目 中 可 以 根据 画图 的 需求 ， 创 建 相应 的 可 画 对 象 ， 这 样 就 可 以 将 这 个 可 画 对 象 当 作 一 块 “ 画 布 
(Canvas)” 在 其 上 面 操 作 可 画 对 象 ， 并 最 终 将 这 种 可 画 对 象 显示 在 画布 上 ,有 点 类 似 于 “内 存 画 布 ”。 


8.32 ”实现 Tween 动画 效果 


通过 本 章 前 面 内 容 学 习 ， 了 解 了 Drawable 可 以 实现 动画 效果 。 其实 Drawable 的 功能 何止 如 此 , 它 
更 加 强大 的 功能 是 可 以 显示 Animation, fE Android SDK 中 提供 了 如 下 两 种 Animation. 

(1) Tween Animation: 通过 对 场景 中 的 对 象 不 断 做 平移 、 缩 放 、 旋 转 等 变换 来 产生 动画 效果 。 

(2) Frame Animation: 和 电影 似 的 顺序 播放 事先 做 好 的 图 像 。 

由 此 可 见 ，Android 平台 提供 了 如 下 两 类 动画 。 

М Tween 动画 : 用 于 对 场景 中 的 对 象 不 断 进 行 图 像 变 换 来 产生 动画 效果 ， 可 以 把 对 象 进行 缩小 、 

放大 、 旋 转 和 渐变 等 操作 。 

M Frame 动画 : 用 于 顺序 播放 事先 做 好 的 图 像 。 

在 使 用 Animation 前 需要 学 会 定义 Animation 的 方法 ，Animation 是 以 XML 格式 定义 的 ， 定 义 好 的 
XML 文件 存放 在 res\anim 目录 中 。Tween Animation 与 Frame Animation 的 定义 、 使 用 都 有 很 大 的 差异 。 

Tween 动画 通过 对 View 的 内 容 完 成 一 系列 的 图 形变 换 ， 通 过 平移 、 缩 放 、 旋 转 、 改 变 透 明度 来 实 
现 动画 效果 。 在 XML 文件 中 ，Tween 动画 主要 包括 以 下 4 种 动画 效果 。 

M Alpha: 渐变 透明 度 动画 效果 。 

М Scale: 渐变 尺寸 伸缩 动画 效果 。 

M Translate: 画面 转移 位 置 移动 动画 效果 。 

M Rotate: 画面 转移 旋转 动画 效果 。 

在 Java 代码 中 ，Tween 动画 对 应 以 下 4 种 动画 效果 。 

回 AlphaAnimation: 渐变 透明 度 动画 效果 。 

ScaleAnimation: 渐变 尺寸 伸缩 动画 效果 。 

TranslateAnimation: 画面 转换 位 置 移动 动画 效果 。 

RotateAnimation: 画面 转移 旋转 动画 效果 。 

Tween 动画 是 通过 预先 定义 一 组 指令 ， 这 些 指 令 指定 了 图 形变 换 的 类 型 、 触 发 时 间 和 持续 时 间 。 
程序 沿 着 时 间 线 执行 这 些 指 令 就 可 以 实现 动画 效果 。 我 们 可 以 首先 定义 Animation 动画 对 象 ， 然 后 设 
置 该 动画 的 一 些 属性 ， 最 后 通过 кашан ЫНЫН. 


实例 文件 TweenCH java 的 主要 代码 如 下 : 


1% У Alpha 动画 */ 


@ 
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private Animation mAnimationAlpha = null; 


定义 Scale 动画 */ 
private Animation mAnimationScale = null; 


/定义 Translate 动画 */ 
private Animation mAnimationTranslate = null; 


ГЕ У Rotate 动画 */ 
private Animation mAnimationRotate= null; 


/定义 Bitmap 对 象 */ 
Bitmap mBitQQ= null; 


public example9(Context context) 


{ 
super(context); 
RAR 
mBitQQ = ((BitmapDrawable) getResources().getDrawable(R.drawable.qq)).getBitmap(); 
} 
public void onDraw(Canvas canvas) 
{ 
super.onDraw(canvas); 
"绘制 图 片 */ 
canvas.drawBitmap(mBitQQ, 0, 0, null); 
} 
public boolean onKeyUp(int keyCode, KeyEvent event) 
{ 


switch ( keyCode ) 


case KeyEvent.KEYCODE_DPAD_UP: 
/创建 Alpha 动画 */ 
mAnimationAlpha = new AlphaAnimation(0.1f, 1.0f); 
”设置 动画 的 时 间 */ 
mAnimationAlpha.setDuration(3000); 
Faia) 
this.startAnimation(mAnimationAlpha); 
break; 
case KeyEvent.KEYCODE_DPAD_DOWN: 
FOE Scale 动画 */ 
mAnimationScale =new ScaleAnimation(0.0f, 1.0f, 0.0f, 1.0f, 
Animation.RELATIVE_TO_SELF, 0.5f, 
Animation.RELATIVE_TO_SELF, 0.5f); 
I" тй BRE TR 
mAnimationScale.setDuration(500); 
A 开始 播放 动画 */ 
this.startAnimation(mAnimationScale); 
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break; 

case KeyEvent.KEYCODE_DPAD_LEFT: 
PA Translate 动画 */ 
mAnimationTranslate = new TranslateAnimation(10, 100,10, 100); 
设置 动画 的 时 间 */ 
mAnimationTranslate.setDuration(1000); 
A/ 开始 播放 动画 */ 
this.startAnimation(mAnimationTranslate); 
break; 

case KeyEvent.KEYCODE_DPAD_RIGHT: 
/创建 Rotate 动画 */ 


mAnimationRotate=new RotateAnimation(0.0f, +360.0f, 
Animation.RELATIVE_TO_SELF,0.5f, 
Animation.RELATIVE_TO_SELF, 0.5f); 
”设置 动画 的 时 间 */ 
mAnimationRotate.setDuration(1000); 
A 开始 播放 动画 */ 
this.startAnimation(mAnimationRotate); 
break; 
} 
return true; 
} 
} 
执行 后 可 以 通过 键盘 的 上 、 下 、 左 、 右 键 实现 动画 效果 ， 如 图 8-8 所 示 。 


8-8 执行 效果 


8.3.3 ”实现 Frame 动画 效果 


在 Android SDK 开发 应 用 中 ， 可 以 使 用 类 AnimationDrawable 来 定义 并 使 用 Frame 动画 。 对 应 
Android SDK 的 位 置 如 下 所 示 。 
E] Tween animation: android.view.animation 包 。 


E] Frame animation: android.graphics.drawable.AnimationDrawable 类 。 

1. AnimationDrawable 介绍 

AnimationDrawable 的 功能 是 获取 、 设 置 动画 的 属性 ， 里 面 最 为 常用 的 方法 如 下 所 示 。 
M intgetDurationQ: 获取 动画 的 时 长 。 

M int getNumberOfFrames(): 获取 动画 的 帧 数 。 

E] boolean isOneShot(): 获取 oneshot 属性 。 
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Void setOneShot(boolean oneshot): 设置 oneshot 属性 。 

void inflate(Resurce r.XmlPullParser p,AttributeSet attrs): 增加 、 获 取 帧 动画 。 
Drawable getFrame(int index): 获取 某 帧 的 Drawable 资源 。 

void addFrame(Drawable frame,int duration) : 为 当前 动画 增加 帧 〈 资 源 、 持 续 时 长 )。 
void start(): 开始 动画 。 

void runQ: 外 界 不 能 直接 调用 ， 使 用 starto tR. 

boolean isRunning(): 当前 动画 是 否 在 运行 。 

void stop: 停止 当前 动画 。 


Frame Animation 格式 定义 


我 们 既 可 以 在 XML Resource 中 定义 Frame Animation， 也 可 以 使 用 AnimationDrawable 中 的 API 
来 定义 。 由 于 Tween Animation 和 Frame Animation 有 着 很 大 的 不 同 ， 所 以 定义 XML 的 格式 也 很 不 相同 。 

定义 Frame Animation 的 格式 是 :首先 是 animation-list 根 节点 ,animation-list 根 节点 中 包含 多 个 item 
子 节点 ， 每 个 пеш 节点 定义 一 帧 动画 ， 定 义 当 前 帧 的 drawable 资源 和 当前 帧 持续 的 时 间 。 表 8-1 对 节 
点 中 的 元 素 进行 了 详细 说 明 。 


AARARARA 
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表 8-1 XML 属性 元 素 说 明 


XML 属性 eA 
drawable 当前 帧 引用 的 drawable 资源 
duration 当前 帧 显示 的 时 间 (毫秒 为 单位 ) 
oneshot WRA tue， 表 示 动 画 只 播放 一 次 停止 在 最 后 一 帧 上 ， 如 果 设 置 为 false 表示 动画 循环 播放 
variablePadding 如 果 为 真 允许 drawable’s 根据 被 选择 的 现状 而 变动 
Visible 规定 drawable 的 初始 可 见 性 ， 默 认为 flase 


3. 使 用 Frame 动画 


使 用 Frame 动画 的 方法 十 分 简单 , 只 需要 创建 一 个 AnimationDrawabledF 对 象 来 表示 Frame 动画 ， 
然后 通过 addFrame 方法 把 每 一 帧 要 显示 的 内 容 添加 进去 ， 最 后 通过 start0 方 法 就 可 以 播放 这 个 动画 ， 
同时 还 可 以 通过 setOneShot0 方 法 设置 是 否 重 复 播放 。 

Frame 动画 主要 是 通过 AnimationDrawable 类 来 实现 的 ,用 start0 和 stop0 这 两 个 重要 的 方法 分 别 启 
动 和 停止 动画 。Frame 动画 一 般 通 过 XML 文件 配置 , 在 Android 工程 的 res/anim 目录 下 创建 一 个 XML 
配置 文件 ， 该 配置 文件 有 一 个 <animation-list> 根 元 素 和 若干 个 <item> 子 元 素 。 

下 面 将 通过 一 个 具体 的 演示 实例 来 讲解 实现 Tween 动画 的 4 种 效果 的 方法 。 


B OB 目 的 | 源码 路 径 
-实例 8-3 — 1| 演示 Tween 动画 的 4 种 动画 效果 光盘 \daima\8wmyActionAnimationEX `: 
本 实例 的 具体 实现 流程 如 下 : 


(1) 编写 文件 my_alpha_action.xml， 实 现 Alpha 渐变 透明 度 动画 效果 ， 主 要 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«set xmlns:android-"http://schemas.android.com/apk/res/android" > 
«alpha 
android:fromAlpha="0.1" 
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android:toAlpha="1.0" 
android:duration="3000" 
> 
<- 透明 度 控制 动画 效果 alpha 
浮 点 型 值 : 
fromAlpha 属性 为 动画 起 始 时 透明 度 
toAlpha 属性 为 动画 结束 时 透明 度 
说 明 : 
0.0 表示 完全 透明 
1.0 表示 完全 不 透明 
以 上 值 取 0.0~1.0 之 间 的 float 数据 类 型 的 数字 
长 整 型 值 : 
duration 属性 为 动画 持续 时 间 
说 明 : 时 间 以 毫秒 为 单位 
--> 


</set> 


(2) 编写 文件 my rotate action.xml, SI Rotate 画面 转移 旋转 动画 效果 ， 


<?xml version="1.0" encoding="utf-8"?> 
<set xmins:android="http://schemas.android.com/apk/res/android"> 
«rotate 
android:interpolator="@android:anim/accelerate_decelerate_interpolator" 
android:fromDegrees="0" 
android:toDegrees="+350" 
android:pivotX="50%" 
android:pivotY="50%" 
android:duration="3000" /> 
<1-- rotate 旋转 动画 效果 
属性 : interpolator 指定 一 个 动画 的 插入 器 
在 试验 过 程 中 ， 使 用 android.res.anim 中 的 资源 时 发 现 有 3 种 动画 插入 器 
accelerate_decelerate_interpolator 加速 -减速 动画 插入 器 


accelerate_interpolator 加 速 -动画 插入 器 
decelerate_interpolator 减速 -动画 插入 器 
浮 点 型 值 : 


fromDegrees 属性 为 动画 起 始 时 物件 的 角度 

toDegrees 属性 为 动画 结束 时 物件 旋转 的 角度 ， 可 以 大 于 360 度 
当 角度 为 负数 ， 表 示 逆 时 针 旋转 

当 角度 为 正 数 ， 表 示 顺 时 针 旋转 

(负数 from—to 正 数 : 顺 时 针 旋转 ) 

(负数 from—to 负数 : 逆 时 针 旋转 ) 

( 正 数 fom 一 一 to 正 数 : 顺 时 针 旋转 ) 

( 正 数 from 一 一 to 负数 : 逆 时 针 旋转 ) 

pivotX 属性 为 动画 相对 于 物件 的 X 坐标 的 开始 位 置 

pivotY 属性 为 动画 相对 于 物件 的 Y 坐标 的 开始 位 置 


E 要 实现 代码 如 下 : 


WA: 以 上 两 个 属性 值 从 0% 一 100% 中 取 值 ，50% 为 物件 的 X 或 Y 方向 坐标 上 的 中 点 位 置 


长 整 型 值 : duration 属性 为 动画 持续 时 间 ， 时 间 以 毫秒 为 单位 


— 


</set> 


(3) 编写 文件 my scale action.xml, SCH Scale 渐变 尺寸 伸缩 动画 效果 ， 主 要 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<set xmins:android="http://schemas.android.com/apk/res/android"> 
«scale android:interpolator="@android:anim/accelerate_decelerate_interpolator" 
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android:fromXScale="0.0" 
android:toXScale-"1.4" 
android:fromYScale-"0.0" 
android:toYScale-"1.4" 
android:pivotX="50%" 
android:pivotY="50%" 
android:fillAfter="false" 
android:duration="700" /> 
</set> 
<- 尺寸 伸缩 动画 效果 scale 
属性 : interpolator 指定 一 个 动画 的 插入 器 


有 3 种 动画 插入 器 

accelerate decelerate interpolator 加速 -减速 动画 插入 器 
accelerate_interpolator 加 速 -动画 插入 器 
decelerate_interpolator 减速 -动画 插入 器 


fromXScale 属性 为 动画 起 始 时 X 坐标 上 的 伸缩 尺寸 
toXScale 属性 为 动画 结束 时 X 坐标 上 的 伸缩 尺寸 
fromYScale 属性 为 动画 起 始 时 Y 坐标 上 的 伸缩 尺 十 
toYScale 属性 为 动画 结束 时 Y 坐标 上 的 伸缩 尺寸 
以 上 4 种 属性 值 


0.0 表示 收缩 到 没有 
1.0 表示 正常 无 伸缩 
值 小 于 1.0 表示 收缩 
值 大 于 1.0 表示 放大 
pivotX 属性 为 动画 相对 于 物件 的 X 坐标 的 开始 位 置 
pivotY 属性 为 动画 相对 于 物件 的 Y 坐标 的 开始 位 置 
以 上 两 个 属性 值 从 0% 一 100% 中 取 值 ，50% 为 物件 的 X sk Y 方向 坐标 上 的 中 点 位 置 
duration 属性 为 动画 持续 时 间 ， 时 间 以 毫秒 为 单位 
fillAfter 属性 应 当 设置 为 rue， 该 动画 转化 在 动画 结束 后 被 应 用 
=--> 
(4) 编写 文件 my translate action.xml, 5:34 Translate 画面 转移 位 置 移 动 动画 效果 ， 主 要 实现 代 
码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«set xmins:android="http://schemas.android.com/apk/res/android"> 
<translate 
android:fromXDelta="30" 
android:toXDelta-"-80" 
android:fromYDelta-"30" 
android:toYDelta-"300" 
android:duration="2000" 
> 
<l- translate 位 置 转移 动画 效果 
fromXDelta 属性 为 动画 起 始 时 X 坐标 上 的 位 置 
toXDelta 属性 为 动画 结束 时 X 坐标 上 的 位 置 
fromYDelta 属性 为 动画 起 始 时 Y 坐标 上 的 位 置 
toYDelta 属性 为 动画 结束 时 Y 坐标 上 的 位 置 
没有 指定 fomXType、toXType、fromYType 和 toYType 时 ， 默 认 是 以 自己 为 相对 参照 物 
duration 属性 为 动画 持续 时 间 ， 时 间 以 毫秒 为 单位 


</set> 
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(5) 编写 文件 myActionAnimation.java， 使 用 case 语句 根据 用 户 的 选择 来 显示 对 应 的 动画 效果 ， 
要 实现 代码 如 下 : 


public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
button_alpha = (Button) findViewByld(R.id.button_Alpha); 
button_alpha.setOnClickListener(this); 
button_scale = (Button) findViewByld(R.id.button_Scale); 
button_scale.setOnClickListener(this); 
button_translate = (Button) findViewByld(R.id.button_Translate); 
button_translate.setOnClickListener(this); 
button_rotate = (Button) findViewByld(R.id.button_Rotate); 
button_rotate.setOnClickListener(this); 


} 
public void onClick(View button) { 
switch (button.getld()) { 
case R.id.button_Alpha: { 
myAnimation Alpha = AnimationUtils.loadAnimation(this,R.anim.my_alpha_action); 
button_alpha.startAnimation(myAnimation_Alpha); 


} 
break; 

case R.id.button_Scale: { 
myAnimation Scale- AnimationUtils.loadAnimation(this,R.anim.my_scale_action); 
button scale.startAnimation(myAnimation Scale); 


} 
break; 

case R.id.button_Translate: { 
myAnimation_Translate= AnimationUtils.loadAnimation(this,R.anim.my_translate_action); 
button_translate.startAnimation(myAnimation_Translate); 


} 
break; 

case R.id.button_Rotate: { 
myAnimation_Rotate= AnimationUtils.loadAnimation(this,R.anim.my_rotate_action); 
button_rotate.startAnimation(myAnimation_Rotate); 


} 
break; 
default: 
break; 
} 


} 
执行 后 的 效果 如 图 8-9 所 示 。 单 击 屏幕 中 的 选项 会 显示 对 应 的 动画 效果 , 例如 单 击 “Translate 动画 
选项 后 的 效果 如 图 8-10 所 示 。 


Translate 
动画 Scale porate 
отт 


5са!е Rotate 
动画 


图 8-9 执行 效果 8-10 Translate 动画 效果 
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84 OpenGL ES 详解 


ERU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \OpenGL ES 详解 .avi 
在 Android 系统 中 ， 通 过 OpenGL 实现 三 维 效果 功能 。 本 节 将 详细 讲解 OpenGL 基础 性 知识 ， 为 
读者 步 入 后 面 知 识 的 学 习 打 下 基础 。 


8.4.1 OpenGL ES 基础 


OpenGL ES (OpenGL for Embedded Systems) 是 OpenGL 三 维 图 形 API 的 子 集 ， 针 对 手机 、PDA 
和 游戏 主机 等 嵌入 式 设 备 而 设计 。 该 API 由 Khronos 集团 定义 推广 , Khronos 是 一 个 图 形 软 硬 件 行业 协 
会 ， 该 协会 主要 关注 图 形 和 多 媒体 方面 的 开放 标准 。OpenGL ES 是 从 OpenGL 裁剪 定制 而 来 的 ， 去 除 
了 glBegin/glEnd、 四 边 形 (GL QUADS), Zit“ (GL POLYGONS) 等 复杂 图 元 等 许多 非 绝 对 必要 
的 特性 。 经 过 多 年 发 展 ， 现 在 主要 有 两 个 版 本 ，OpenGL ES 1.x 针对 固定 管线 硬件 ，OpenGL ES 2.x 针 
对 可 编程 管线 硬件 。OpenGL ES 1.0 是 以 OpenGL 1.3 规范 为 基础 的 ，OpenGL ES 1.1 是 以 OpenGL 1.5 
规范 为 基础 的 ， 它 们 分 别 又 支持 common 和 common lite Pj profile. lite profile 只 支持 定点 实数 ， 而 
common profile 既 支 持 定点 数 又 支持 浮 点 数 .OpenGL ES 2.0 则 是 参照 OpenGL 2.0 规范 定义 的 ,common 
profile 发 布 于 2005 年 8 月 ， 引 入 了 对 可 编程 管线 的 支持 。 

OpenGL ES 的 最 大 意义 是 作为 嵌入 式 3D 图 形 算法 标准 。 因 为 OpenGL ES 是 免 授 权 费 的 、 跨 平台 
的 、 功 能 完善 的 2D 和 3D 图 形 应 用 程序 接口 API， 它 针对 多 种 嵌入 式 系统 实现 了 专门 设计 ， 这 些 设计 
包括 控制 台 、 移 动 电话 、 手 持 设备 、 家 电 设备 和 汽车 。OpenGL ES 由 精心 定义 的 桌面 OpenGL TRH 
成 ， 创 造 了 软件 与 图 形 加 速 器 之 间 灵 活 强大 的 底层 交互 接口 。OpenGL ES 包含 浮 点 运算 和 定点 运算 系 
统 描述 以 及 EGL 针对 便携 设备 的 本 地 视窗 系统 规范 。OpenGL ES 1.x 面向 功能 固定 的 硬件 所 设计 并 提 
供 加 速 支持 、 图 形 质量 及 性 能 标准 。OpenGL ES 2.x 则 提供 包括 遮盖 器 技术 在 内 的 全 可 编程 3D 图 形 算 
ik. OpenGL ES-SC 专 为 有 高 安全 性 需求 的 特殊 市 场 精心 打造 。 


8.4.2 Android 用 到 OpenGL ES 


在 Android 系统 中 用 到 的 是 OpenGL 图 形 函 数 库 ， 它 可 以 实现 跨 平 台 操作 。Android 系统 真正 所 用 
到 的 是 它 的 一 个 子 集 OpenGL ES (OpenGL for Embedded Systems 〈 嵌 入 式 系统 ))， 这 是 OpenGL AIK 
入 式 版 本 。 

Android 系统 使 用 OpenGL 的 标准 接口 来 支持 3D 图 形 功 能 , Android 3D 图 形 系统 也 分 为 Java 框架 
和 本 地 代码 两 部 分 。 本 地 代码 主要 实现 OpenGL 接口 的 库 ， 在 Java 框架 层 ，javax.microedition .khronos. 
opengles 是 Java 标准 的 OpenGL 包 ，android.opengl 包 提供 了 OpenGL 系统 和 Android GUI 系统 之 间 的 
联系 。 

Android 的 本 地 代码 位 于 目录 frameworks/base/opengl 中 。 

INI 代码 位 于 目录 frameworks/base/core/com google android gles jni GLImpl.cpp 和 frameworks/base/ 


core/com google android gles jni EGLImpl.cpp 中 。 
© 
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Java 类 位 于 目录 opengl/java/javax/microedition/khronos 中 。 


8.4.8 OpenGL ES 的 基本 操作 


1. 构造 OpenGL ES View 


在 Andorid 系统 中 构造 一 个 OpenGL View 的 方法 非常 简单 , 只 需要 完成 如 下 两 个 方面 的 工作 即 可 。 
(1) GLSurfaceView 
在 android.opengl. javax.microedition.khronos.egl, javax.microedition.khronos.opengles 和 java.nio 等 


包 中 ，Android 系统 提供 了 OpenGL ES АРІ 的 主要 定义 。 其 中 GLSurfaceView 是 这 些 包 的 核心 类 , 主要 
功能 如 下 : 


» 


串联 OpenGL ES 与 Android 的 View 层次 结构 之 间 的 桥梁 作用 。 
使 Open GL ES 库 适 应 于 Anndroid 系统 的 Activity 生命 周期 。 
更 加 容易 选择 合适 的 Frame Buffer 像素 格式 。 
创建 和 管理 单独 绘图 线程 以 达到 平滑 动画 效果 。 
提供 了 方便 使 用 的 调试 工具 来 跟踪 OpenGL ES 函数 调用 以 帮助 检查 错误 。 
由 此 可 见 ， 编 写 OpenGL ES 应 用 的 第 一 步 是 从 类 GLSurfaceView 开始 的 ， 在 设置 GLSurfaceView 
只 需 调 用 一 个 方法 来 设置 OpenGLView 用 到 的 GLSurfaceView.Renderer 即 可 。 
public void setRenderer(GLSurfaceView.Renderer renderer) 
(2) GLSurfaceView.Renderer 
类 GLSurfaceView.Renderer 定义 了 一 个 统一 图 形 绘制 的 接口 ， 在 里 面 定义 了 如 下 3 个 接口 函数 。 
public void onSurfaceCreated(GL10 gl, EGLConfig config) 
public void onDrawFrame(GL10 gl) 
public void onSurfaceChanged(GL10 gl, int width, int height) 


在 上 述 接口 函数 中 ， 各 个 参数 的 具体 说 明 如 下 所 示 。 

onSurfaceCreated: 在 这 个 方法 中 主要 用 来 设置 一 些 绘制 时 不 常 变化 的 参数 ， 如 背景 色 、 是 否 
打开 z-buffer 等 。 

onDrawFrame: 定义 实际 的 绘图 操作 。 

onSurfaceChanged: 如 果 设 备 支持 屏幕 横向 和 纵向 切换 ， 这 个 方法 将 发 生 在 横向 <> 纵向 互 
换 时 。 此 时 可 以 重新 设置 绘制 的 纵横 比率 。 


2. 基本 3D 绘图 处 理 
一 个 3D 图 形 通常 是 由 一 些小 的 基本 元 素 (顶点 、 边 、 面 和 多 边 形 ) 构成 ， 每 个 基本 元 素 都 可 以 单 
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独 来 操作 。 下 面 将 简要 介绍 3D 绘图 的 一 些 基本 构成 要 素 , 为 步 入 本 书后 面 知识 的 学 习 打 下 一 个 坚实 的 
基础 。 


(1) 顶点 
顶点 CVertex) 是 3D 建 模 时 用 到 的 最 小 构成 元 素 ， 顶 点 定义 为 两 条 或 是 多 条 边 交 会 的 地 方 。 在 3D 


位 置 。 图 8-11 中 标识 为 黄色 的 点 都 是 顶点 (Vertex)。 


在 Android 系统 中 , 可 以 使 用 一 个 浮 点 数 数组 来 定义 一 个 顶点 , 通常 将 浮 点 数 数组 放 在 一 个 Buffer 


@ 
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(javanio) 中 以 提高 性 能 。 图 8-12 中 定义 了 4 个 顶点 。 
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图 8-11 顶点 图 8-12 4 个 顶点 
在 Android 系统 中 ， 可 以 通过 如 下 代码 来 定义 图 8-13 中 的 4 个 顶点 。 


private float vertices[] = { 

-1.0f, 1.0f, 0.0f, /0 

-1.0f, -1.0f, 0.0f, //1 

1.0f, -1.0f, 0.0f, /2 

1.0f, 1.0f, 0.0f, //3 
k 

为 了 提高 程序 的 性 能 ， 我 们 通常 将 这 些 数组 存放 到 java.io 定义 的 Buffer 类 中 ， 代 码 如 下 : 
ByteBuffer vbb = ByteBuffer.allocateDirect(vertices.length * 4); 
vbb.order(ByteOrder.nativeOrder()); 
FloatBuffer vertexBuffer = vbb.asFloatBuffer(); 
vertexBuffer.put(vertices); 
vertexBuffer.position(0); 


在 定义 顶点 之 后 , 接 下 来 需要 将 它们 传 给 OpenGL ES Je, 此 传递 功能 是 通过 OpenGL ES 提供 的 “ 管 
道 Pipeline” 机 制 实现 的 。 此 管道 定义 了 一 些 “开关” 来 控制 OpenGL ES 支持 的 某 些 功 能 ， 在 默认 情 
况 下 这 些 功能 是 关闭 的 ， 如 果 需 要 使 用 OpenGL ES 的 这 些 功能 ， 需 要 明确 告知 OpenGL“ 管 道 ”打开 
所 需 功 能 。 

(2) № 

W (Edge) 定义 为 两 个 顶点 之 间 的 线段 。 边 是 面 和 多 边 形 的 边界 线 。 在 3D 模型 中 ， 边 可 以 被 相 
邻 的 两 个 面 或 是 多 边 形 所 共享 。 对 一 个 边 做 变换 将 影响 边 相 接 的 所 有 项 点 、 面 或 多 边 形 。 在 OpenGL 
中 ， 通 常 无 须 直接 来 定义 一 个 边 ， 而 是 通过 顶点 定义 一 个 面 ， 从 而 由 面 定 义 其 所 对 应 的 3 条 边 。 可 以 
通过 修改 边 的 两 个 顶点 来 更 改 一 条 边 ， 图 8-13 中 的 黄色 线段 代表 一 条 边 。 

(3) 面 

在 OpenGL ES 中 的 面 (Face) 特 指 一 个 三 角形 ， 由 3 个 顶点 和 3 条 边 构成 ， 对 一 个 面 所 做 的 变化 
影响 到 连接 面 的 所 有 项 点 和 边 以 及 面 多 边 形 。 图 8-14 中 的 黄色 区 域 代表 一 个 面 。 
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图 8-13 iW 图 8-14 i 


(4) 多 边 形 

多 边 形 (Polygon) 由 多 个 面 (三 角形 ) 拼接 而 成 ,在 三 维 空间 上 ， 多 边 形 不 一 定 表 示 这 个 Polygon 
在 同一 平面 上 。 这 里 使 用 默认 的 逆 时 针 方 向 代表 面前 面 (Front)。 图 8-15 中 的 黄色 区 域 是 一 个 多 边 形 。 

在 Android 系统 中 使 用 项 点 和 buffer 来 定义 多 边 形 ， 图 8-16 中 定义 了 一 个 正方 形 。 


vo v3 
e + 
+ t + x 
4" | 42 


8-16 定义 了 一 个 正方 形 


8-15 多边形 


图 8-16 中 正方 形 对 应 的 顶点 和 buffer 的 定义 代码 如 下 : 
private short[] indices ={ 0, 1, 2, 0, 2, 3}; 

ByteBuffer ibb = ByteBuffer.allocateDirect(indices.length * 2); 
ibb.order(ByteOrder.nativeOrder()); 

ShortBuffer indexBuffer = ibb.asShortBuffer(); 


indexBuffer.put(indices); 
indexBuffer.position(0); 
(5) Render їй 
在 定义 好 多 边 形 后 ， 需 要 了 解 和 使 用 OpenGL ES 的 API 来 绘制 并 渲染 (Render) ZALA. f 
OpenGL ES 中 ， 提 供 了 如 下 两 种 方法 来 绘制 一 个 空间 几何 图 形 。 
public abstract void glDrawArrays(int mode, int first, int count): 使 用 VetexBuffer 来 绘制 ， 顶 点 
的 顺序 由 vertexBuffer 中 的 顺序 指定 。 
М public abstract void glDrawElements(int mode, int count, int type, Buffer indices): 可 以 重新 定义 
顶点 的 顺序 ， 顶 点 的 顺序 由 indices Buffer 指定 。 
下 面 将 通过 一 个 具体 实例 来 讲解 使 用 OpenGL ES 绘制 一 个 正方 形 的 方法 。 
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本 实例 代码 的 具体 实现 流程 如 下 : 
(1) 编写 布局 文件 main.xml， 具 体 代 码 如 下 : 
<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
> 

<TextView 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/hello" 
> 

</LinearLayout> 


(2) 编写 文件 zheng.java， 在 此 定义 类 zheng， 通 过 前 面 介绍 的 步骤 在 屏幕 中 绘制 一 个 正方 形 。 具 
体 代码 如 下 : 


package ex.zheng; 


import java.nio.ByteBuffer; 
import java.nio.ByteOrder; 
import java.nio.FloatBuffer; 
import java.nio.ShortBuffer; 


import javax.microedition.khronos.opengles.GL 10; 
public class zheng ( 
private float vertices[] 7 ( 
-1.0f, 1.0f, 0.0f, 
-1.0f, -1.0f, 0.01, 
1.0f, -1.0f, 0.0f, 
1.0f, 1.0f, 0.0f, 
E 
private short[] indices = (0, 1, 2, 0, 2,3}; 
private FloatBuffer vertexBuffer; 
private ShortBuffer indexBuffer; 


public zheng() { 
ByteBuffer vbb = ByteBuffer.allocateDirect(vertices.length * 4); 
vbb.order(ByteOrder.nativeOrder()); 
vertexBuffer = vbb.asFloatBuffer(); 
vertexBuffer.put(vertices); 
vertexBuffer.position(0); 
ByteBuffer ibb = ByteBuffer.allocateDirect(indices.length * 2); 
ibb.order(ByteOrder.nativeOrder()); 
indexBuffer = ibb.asShortBuffer(); 
indexBuffer.put(indices); 
indexBuffer.position(0); 
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} 
public void draw(GL10 gl) { 
gl.giFrontFace(GL8.GL CCW); 
gl.glEnable(GL8.GL, СОЦ. FACE); 
gl.giCullFace(GL8.GL. BACK); 
gl.glEnableClientState(GL8.GL, VERTEX ARRAY); 
gl.glVertexPointer(3, GL8.GL FLOAT, 0, 
vertexBuffer); 
gl.glIDrawElements(GL8.GL_TRIANGLES, indices.length, 
GL8.GL_UNSIGNED_SHORT, indexBuffer); 
gl.glDisableClientState(GL8.GL_VERTEX_ARRAY); 
gl.glDisable(GL8.GL СОЦ. FACE); 
) 
} 
执行 后 的 效果 如 图 8-17 所 示 。 
3. 变换 3D 坐标 
OpenGL ES 使 用 了 右手 坐标 系统 ， 右 手 坐 标 系 判断 方法 : 在 空间 直角 坐标 
系 中 ,让 右手 拇指 指向 X 轴 的 正方 向 ， 食 指 指向 立轴 的 正方 向 ， 如 果 中 指 能 指 
向 Z 轴 的 正方 向 , 则 称 这 个 坐标 系 为 右手 直角 坐标 系 。 在 使 用 OpenGL ES 绘制 
的 3D 坐标 系统 中 ， 可 以 通过 改变 transformations 的 方式 实现 3D 坐标 的 变换 。 
(1) 使 用 Translate 实现 平移 变换 
在 OpenGL ES 中 ， 使 用 方法 public abstract void glTranslatef(float x, float y, 
float z) 实 现 坐 标 平移 变换 。 例 如 通过 坐标 平移 变换 来 移动 Android 屏幕 中 的 三 
维 图 形 ， 还 可 以 进行 多 次 平移 变换 ， 其 结果 为 多 个 平移 矩阵 的 累计 结果 ， 和 矩阵 
的 顺序 不 重要 ， 可 以 互 换 。 
(2) 使 用 Rotate 实现 旋转 


8-17 执行 效果 


在 OpenGL ES 中 , 使 用 方法 public abstract void glRotatef(float angle, float x, float y, float z) 实 现 选 择 
坐标 旋转 功能 ， 单 位 为 角度 。(x:yYz) 定义 旋转 的 参照 矢量 方向 ， 多 次 旋转 的 顺序 非常 重要 。 


假如 选择 一 个 般 子 ， 首 先 按 下 列 顺序 选择 3 次 。 
gl.glRotatef(90f, 1.0f, 0.0f 0.00); 
gl.glRotatef(90f, 0.0f 1.0f, 0.00); 
gl.glRotatef(90f, 0.0f 0.01, 1.00); 


旋转 过 程 如 图 8-18 所 示 。 


图 8-18 Ж ИТ 


如 果 想 逆向 旋转 回 原先 的 初始 状态 ， 需 要 进行 如 下 旋转 。 
gl.glRotatef(90f, -1.0f, 0.0f 0.01); 
gl.glRotatef(90f, 0.0f -1.0f, 0.0f); 
gl.glRotatef(90f, 0.0f 0.0f -1.0f); 
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逆向 旋转 过 程 如 图 8-19 所 示 。 


Ya 


н 


8-19 ЖРТ 


(3) 使 用 Translate & Rotate 实现 平移 和 旋转 组 合 变换 
在 OpenGL ES 中 ， 在 对 Mesh 〈 网 格 ， 构 成 三 维 形体 的 基本 单位 ) 同时 进行 平移 和 选择 变换 时 ， 
坐标 变换 的 顺序 也 直接 影响 最 终 的 结果 。 在 变换 时 ,坐标 变换 都 是 相对 于 变换 的 Mesh 本 身 的 坐标 系 而 
进行 的 。 
(4) Scale 缩放 
在 OpenGL ES 中 ， 使 用 方法 public abstract void glScalef (float x, float y, float z) 实 现 缩放 功能 。 
(5) 矩阵 操作 ， 单 位 矩阵 
在 进行 平移 、 旋 转 和 缩放 变换 操作 时 ， 所 有 的 变换 都 是 针对 当前 的 矩阵 〈 与 当前 矩阵 相 乘 )。 在 具 
体 实现 上 ，OpenGL ES 使 用 如 下 函数 实现 。 
М public abstract void glLoadIdentity(): 将 当前 矩阵 恢复 为 最 初 的 无 变换 的 矩阵 ， 用 单位 矩阵 (无 
平移 、 缩 放 、 旋 转 ) 实现 。 
回 public abstract void glPushMatrix0 和 public abstract void glPopMatrix0: 在 栈 中 保存 当前 矩阵 和 
从 栈 中 恢复 所 存 和 矩阵 。 
进行 坐标 变换 的 一 个 好 习惯 是 在 变换 前 使 用 glPushMatrix 保存 当前 矩阵 ， 完 成 坐标 变换 操作 后 ， 
再 调用 glPopMatrix 恢复 原先 的 矩阵 设置 。 


4. 添加 颜色 


使 用 OpenGL ES 可 以 给 绘制 的 图 形 填充 颜色 ，OpenGL ES 支持 的 颜色 模式 是 RGBA 模式 ( 红 、 
绿 、 蓝 、 透 明度 )。 在 定义 颜色 时 , OpenGL 使 用 0…1 之 间 的 浮 点 数 表示 。0 73 0, 1 相当 于 255 (OxFF )。 
最 简单 的 上 色 方 法 是 顶点 着 色 (Vertxt coloring) 法 ， 不 但 可 以 使 用 单 色 ， 而 且 也 可 以 定义 颜色 渐变 或 
者 使 用 材质 (类 同 于 二 维 图 形 中 各 种 Brush 类 型 )。 
(1) Flat coloring ( 单 色 ) 
Flat coloring 是 通知 OpenGL 使 用 单一 的 颜色 来 泻 染 ，OpenGL 将 一 直 使 用 指定 的 颜色 来 演 染 直到 
指定 其 他 的 颜色 。 指 定 颜色 的 方法 为 glColor4f0， 具 体格 式 如 下 : 
public abstract void glColor4f(float red, float green, float blue, float alpha) 
默认 的 是 red、green 和 blue， 值 为 1， 代 表白 色 ， 这 也 是 为 什么 在 本 章 前 面 实例 中 绘制 的 正方 形 是 
白色 的 原因 。 可 以 创建 一 个 新 类 FlatColoredSquare 作为 Sequare 的 子 类 ， 将 它 的 draw 重 定义 为 如 下 
格式 。 
public void draw(GL10 gl) { 
gl.giColor4f(0.5f, 0.5f 1.0f 1.00); 
super.draw(gl); 
} 
然后 将 OpenGLRenderer 的 square 类 型 改 为 FlatColoredSquare。 
private FlatColoredSquare square=new FlatColoredSquare(); 
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此 时 如 果 编 译 运 行 ， 正 方形 颜色 将 变 成 蓝 色 。 
(2) Smooth coloring (平滑 颜色 过 渡 ) 
当 给 每 个 顶点 定义 一 个 颜色 值 时 ，OpenGL ES 会 自动 在 不 同 项 点 颜色 之 间 生 成 中 间 过 渡 颜 色 ， 即 


渐变 色 。 
8.4.4 


绘制 图 形 


至 此 , 在 本 章 前 面 讲解 的 实例 中 , 绘制 的 都 不 能 算是 三 维 效 果 图 形 。 下 面 将 详细 讲解 使 用 OpenGL 


ES 绘制 三 维 图 形 的 方法 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


在 现实 世界 中 ，Mesh (网 格 ， 三 角 面 ) 是 构成 空间 形体 的 基本 元 素 ， 本 章 前 面 的 正方 形 也 是 由 两 
个 Mesh 构成 的 ,下 面 将 通过 一 个 具体 实例 来 讲解 使 用 Mesh 构成 四 面体 和 椎 体 等 基本 空间 形体 的 方法 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 编写 文件 wangjava， 在 此 文件 中 定义 一 个 基 类 wang， 设 置 所 有 空间 形体 最 基本 的 构成 元 素 


为 Mesh 


类 型 (三 角形 网 格 )。 文 件 wang java 的 具体 代码 如 下 : 


package ex.san.mesh; 

import java.nio.ByteBuffer; 

import java.nio.ByteOrder; 

import java.nio.FloatBuffer; 

import java.nio.ShortBuffer; 

import javax.microedition.khronos.opengles.GL10; 
import android.graphics.Bitmap; 

import android.opengl.GLUtils; 

public class wang { 


б 


private FloatBuffer mVerticesBuffer = null; 
private ShortBuffer mindicesBuffer = null; 
private FloatBuffer mTextureBuffer; 

private int mTextureld = -1; 

private Bitmap mBitmap; 

private boolean mShouldLoadTexture = false; 
private int mNumOflndices = -1; 


private final float] mRGBA = new float[] ( 1.0f, 1.0, 1.0f, 1.0f }; 


private FloatBuffer mColorBuffer = null; 

public float x = 0; 

public float y = 0; 

public float z = 0; 

public float rx = 0; 

public float ry = 0; 

public float rz = 0; 

public void draw(GL10 gl) { 
gl.glFrontFace(GL8.GL_CCW); 
gl.glEnable(GL8.GL_CULL_FACE); 
gl.giCullFace(GL8.GL. BACK); 
gl.glEnableClientState(GL8.GL VERTEX, ARRAY); 
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gl.giVertexPointer(3, GL8.GL_FLOAT, 0, mVerticesBuffer); 

gl.giColor4f(mRGBA[0], mRGBA[1], mRGBA[2], mRGBA[3]); 

if (mColorBuffer != null) ( 
gl.glEnableClientState(GL8.GL COLOR ARRAY); 
gl.giColorPointer(4, GL8.GL. FLOAT, 0, mColorBuffer); 


} 

if (mShouldLoadTexture) { 
loadGLTexture(gl); 
mShouldLoadTexture = false; 

} 


if (mTextureld != -1 && mTextureBuffer != null) { 
gl.glEnable(GL8.GL_TEXTURE_2D); 
gl.glEnableClientState(GL8.GL TEXTURE COORD ARRAY); 
gl.gITexCoordPointer(2, GL8.GL FLOAT, 0, mTextureBuffer); 
gl.glBindTexture(GL8.GL TEXTURE 2D, mTextureld); 


) 
gl.giTranslatef(x, у, z); 
gl.glRotatef(rx, 1, 0, 0); 
gl.glRotatef(ry, 0, 1, 0); 
gl.glRotatef(rz, 0, 0, 1); 
gl.gIDrawElements(GL8.GL_TRIANGLES, mNumOfindices, 
GL8.GL UNSIGNED SHORT, mindicesBuffer); 
gl.giDisableClientState(GL8.GL VERTEX ARRAY); 
if (mTextureld != -1 && mTextureBuffer != null) ( 
gl.giDisableClientState(GL8.GL TEXTURE СООКО ARRAY); 


} 
gl.giDisable(GL8.GL СОШ FACE); 


protected void setVertices(float[] vertices) ( 
ByteBuffer vbb = ByteBuffer.allocateDirect(vertices.length * 4); 
vbb.order(ByteOrder.nativeOrder()); 
mVerticesBuffer = vbb.asFloatBuffer(); 
mVerticesBuffer.put(vertices); 
mVerticesBuffer.position(0); 

} 

protected void setIndices(short[] indices) { 
ByteBuffer ibb = ByteBuffer.allocateDirect(indices.length * 2); 
ibb.order(ByteOrder.nativeOrder()); 
mindicesBuffer = ibb.asShortBuffer(); 
mindicesBuffer.put(indices); 
mindicesBuffer.position(0); 
mNumOfindices = indices.length; 

} 

protected void setTextureCoordinates(float[] textureCoords) ( //New 
ByteBuffer byteBuf = ByteBuffer 

-allocateDirect(textureCoords.length * 4); 

byteBuf.order(ByteOrder.nativeOrder()); 
mTextureBuffer = byteBuf.asFloatBuffer(); 
mTextureBuffer.put(textureCoords); 
mTextureBuffer.position(0); 


309 


DO Android 攀 联 网 开发 从 入 门 到 实 必 


protected void setColor(float red, float green, float blue, float alpha) { 
mRGBA[0] = red; 
mRGBA[1] = green; 
mRGBA[2] = blue; 
mRGBA[3] = alpha; 

) 

protected void setColors(float[] colors) { 
ByteBuffer cbb = ByteBuffer.allocateDirect(colors.length * 4); 
cbb.order(ByteOrder.nativeOrder()); 
mColorBuffer = cbb.asFloatBuffer(); 
mColorBuffer.put(colors); 
mColorBuffer.position(0); 


} 

public void loadBitmap(Bitmap bitmap) { 
this.mBitmap = bitmap; 
mShouldLoadTexture = true; 


private void loadGLTexture(GL10 gl) { 
int[] textures = new int[1]; 
gl.glGenTextures(1, textures, 0); 
mTextureld = textures[0]; 
gl.giBindTexture(GL8.GL TEXTURE 2D, mTextureld); 
gl.giTexParameterf(GL8.GL TEXTURE 2D, GL8.GL TEXTURE MIN FILTER, 
618.61 LINEAR); 
gl.giTexParameterf(GL8.GL TEXTURE 2D, GL8.GL TEXTURE MAG FILTER, 
GL8.GL. LINEAR); 
gl.giTexParameterf(GL8.GL TEXTURE 2D, GL8.GL TEXTURE WRAP S, 
618.61 REPEAT); 
gl.giTexParameterf(GL8.GL TEXTURE. 2D, GL8.GL TEXTURE WRAP T, 
618.61 REPEAT); 
GLUtils.teximage2D(GL8.GL TEXTURE 2D, 0, mBitmap, 0); 
} 
} 
在 上 述 代 码 中 ， 需 要 注意 如 下 5 点 。 
setVertices: 允许 子 类 重新 定义 顶点 坐标 。 
setIndices: 人 允许 子 类 重新 定义 顶点 的 顺序 。 
setColor/setColors: 人 允许 子 类 重新 定义 颜色 。 
X. y. z: 定义 平移 变换 的 参数 。 
IX. ту, rz: 定义 旋转 变换 的 参数 。 
(2) 编写 文件 fang.java， 在 此 文件 中 定义 类 fang, fang 可 以 有 宽度 、 高 度 和 深度 ， 宽 度 定义 为 沿 
X 轴 方 向 的 长 度 ， 深 度 定义 为 沿 Z 轴 方 向 的 长 度 ， 高 度 为 Y 轴 方 向 。 文 件 fangjava 的 具体 代码 如 下 : 
package ex.san.mesh; 
public class fang extends wang { 
public fang() { 
this(1, 1); 


инана 


} 
public fang(float width, float height) { 
float textureCoordinates[] = { 0.0f, 2.01, 2.0f, 2.0f, 0.0f, 0.0f, 
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2.0f, 0.0f, }; 
short[] indices = new short[] ( 0, 1, 2, 1, 3, 2); 
float[] vertices = new float[] ( -0.5f, -0.5f, 0.01, 0.51, -0.5f, 0.0f, 
-0.5f, 0.51, 0.01, 0.51, 0.51, 0.0f }; 
setindices(indices); 
setVertices(vertices); 
setTextureCoordinates(textureCoordinates); 
} 
} 
(3) 编写 文件 Group.java， 在 此 文件 中 定义 了 类 Group， 该 类 可 以 管理 多 个 空间 几何 形体 ， 如 果 
把 Mesh 比 作 Android 的 View, 那么 可 以 把 Group 看 作 Android 的 ViewGroup。 此 处 类 Group 的 主要 功 
能 是 把 针对 Group 的 操作 (如 draw) 分 发 到 Group 中 的 每 个 成 员 对 应 的 操作 (如 draw)。 文 件 Group.java 
的 具体 代码 如 下 : 
package ex.san.mesh; 
import java.util. Vector; 
import javax.microedition.khronos.opengles.GL10; 
public class Group extends wang { 
private final Vector<wang> mChildren = new Vector<wang>(); 
@Override 
public void draw(GL10 gl) { 
int size = mChildren.size(); 
for (int i = 0; i < size; i++) 
mChildren.get(i).draw(gl); 


} 

public void add(int location, wang object) { 
mChildren.add(location, object); 

} 

public boolean add(wang object) { 
return mChildren.add(object); 

} 

public void clear() { 
mChildren.clear(); 

} 

see java.util. Vector#get(int) 

public wang get(int location) { 
return mChildren.get(location); 

} 

public wang remove(int location) { 
return mChildren.remove(location); 

} 

public boolean remove(Object object) { 
return mChildren.remove(object); 

n 

public int size() ( 
return mChildren.size(); 

) 

} 


执行 后 将 会 在 屏幕 中 形成 一 个 三 维 效果 图 的 图 案 ， 执 行 效果 如 图 8-20 所 示 。 
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图 8-20 ”执行 效果 
85 音频 开发 


Би 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \ 音 频 开 发 .avi 
在 多 媒体 领域 中 ， 音 频 永远 是 主流 应 用 之 一 。 本 节 将 详细 讲解 在 Android 平台 中 开发 音频 应 用 基 
本 知识 ， 为 读者 步 入 后 面 知识 的 学 习 打下 基础 。 


854 音频 接口 类 


在 Android 系统 中 ， 通 过 如 下 所 示 的 接口 类 来 实现 音频 功能 。 
音乐 类 型 的 音频 资源 : 通过 MediaPlayer 来 播放 。 
音调 : 通过 ToneGenerator 来 播放 。 
提示 音 : 通过 Ringtone 来 播放 。 
游戏 中 的 音频 资源 : 通过 SoundPool 来 播放 。 
音 功能 : 通过 MediaRecorder 和 AudioRecord 等 来 记录 音频 。 
除了 上 述 功能 类 之 外 ，Android 还 提供 了 实现 音量 调节 和 音频 设备 的 管理 等 功能 的 类 ， 这 些 类 的 具 
体 说 明 如 下 所 示 。 
М AudioManager: 通过 音频 服务 ， 为 上 层 提供 了 音量 和 铃声 模式 控制 的 接口 ， 铃 声 模式 控制 包 
括 扬声器 、 耳 机 、 蓝 牙 等 是 否 打 开 ， 麦 克 风 是 否 静 音 等 。 在 开发 多 媒体 应 用 时 会 经 常用 到 
AudioManager。 
AudioSystem: 提供 了 定义 音频 系统 的 基本 类 型 和 基本 操作 的 接口 ， 对 应 的 JNI 接口 文件 为 
android media AudioSystem.cpp。 在 Android 音频 系统 中 主要 包括 如 下 类 型 。 
STREAM VOICE CALL 
STREAM SYSTEM 
STREAM RING 
STREAM MUSIC 
STREAM ALARM 
STREAM NOTIFICATION 
STREAM BLUETOOTH SCO 
STREAM SYSTEM ENFORCED. 
STREAM DIMF 
> STREAM TIS 
AudioTrack: 直接 为 PCM 数据 提供 支持 ， 对 应 的 JNI 接 口 文件 为 android media AudioTrack.cpp. 


m 
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AudioRecord: 是 音频 系统 的 录音 接口 ， 默 认 的 编码 格式 为 PCM_16_BIT， 对 应 的 INI 接口 文 
件 为 android media AudioRecord.cpp。 

M Ringtone 和 RingtoneManager: 为 铃声 、 提 示 音 、 闹 钟 等 提供 了 快速 播放 以 及 管理 的 接口 ， 实 
质 是 对 媒体 播放 器 提供 了 一 个 简单 的 封装 。 

ToneGenerator: 提供 了 对 ОТМЕ 音 (ITU-T Q.23)， 以 及 呼叫 监督 音 (3GPP TS 22.001)、 专 上 
Тї (3GPP TS 31.111) 中 规定 的 音频 的 支持 ， 根 据 呼叫 状态 和 漫游 状态 ， 该 文件 产生 的 音频 路 
径 为 下 行 音频 或 者 传输 给 扬声器 或 耳机 。 对 应 的 ЛП 接口 文件 为 android media Tone 
Generator.cpp。 其 中 DTMF 音 为 WAV 格式 ， 相 关 的 音频 类 型 定义 位 于 文件 ToneGeneratorh 中 。 

SoundPool: 能 够 播放 音频 流 的 组 合 音 ， 主 要 被 应 用 在 游戏 领域 。 对 应 的 INI 接口 为 android_ 
media SoundPool.cpp. 

SoundPool: 可 以 从 АРК 包 中 的 资源 文件 或 者 文件 系统 中 的 文件 将 音频 资源 加 载 到 内 存 中 。 

在 底层 的 实现 上 ，SoundPool 通过 媒体 播放 服务 可 以 将 音频 资源 解码 为 一 个 16bit 的 单 声 道 或 

者 立体 声 的 PCM 流 ， 这 使 得 应 用 避免 了 在 回放 过 程 中 进行 解码 造成 的 延迟 。 

除了 回放 过 程 中 延迟 小 的 优点 外 ，SoundPool 还 能 够 对 一 定数 量 的 音频 流 进行 同时 播放 。 当 要 

播放 的 音频 流 数 量 超过 SoundPool 所 设 定 的 最 大 值 时 ,SoundPool 将 会 停止 已 播放 的 一 条 低 优 

先 级 的 音频 流 。SoundPool 最 大 播放 音频 流 数量 的 设置 ， 可 以 避免 CPU 过 载 和 影响 UI 体验 。 

android.media.audiofx 包 : 这 是 从 Android 2.3 开始 新 增 的 包 , 提供 了 对 单 曲 和 全 局 的 音效 的 支 

持 ， 包 括 重 低音 、 环 绕 音 、 均 衡器 、 混 响 和 可 视 化 等 声音 特效 。 
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8.5.2 AudioManager 控制 铃声 


在 Android 系统 中 , 因为 类 AudioManager 在 包 android. Media 中 定义 , 所 以 其 地 址 是 android. Media. 
AudioManager， 该 类 能 够 设置 访问 控制 音量 和 铃声 模式 。 
(D 方法 
在 类 AudioManager 中 是 通过 方法 实现 音频 功能 的 ， 其 中 最 为 常用 的 方法 如 下 所 示 。 
adjustVolume(int direction, int flags): 用 来 控制 手机 音量 大 小 ， 当 传 入 的 第 一 个 参数 为 Audio 
Manager.ADJUST_LOWER 时， 可 将 音量 调 小 一 个 单位 ， 传 入 AudioManager.ADJUST_RAISE 
时 ， 则 可 以 将 音量 调 大 一 个 单位 。 
getMode(): 返回 当前 音频 模式 。 
getRingerMode(): 返回 当前 的 铃声 模式 。 
getStreamVolume(int streamType): 取得 当前 手机 的 音量 ， 最 大 值 为 7， 最 小 值 为 0， 当 为 0 时 ， 
手机 自动 将 模式 调整 为 “振动 模式 ”。 
B setRingerMode(int ringerMode): 改变 铃声 模式 。 
(2) 声音 模式 
手机 都 有 声音 模式 ， 声 音 、 静 音 还 有 振动 ， 甚 至 振动 加 声音 兼备 ， 这 些 都 是 手机 的 基本 功能 。 在 
Android 手机 中 ， 我 们 同样 可 以 通过 Android 的 SDK 提供 的 声音 管理 接口 来 管理 手机 声音 模式 以 及 调 
整 声音 大 小 ， 这 就 是 Android 中 AudioManager 的 使 用 。 
М ”设置 声音 模式 
// 声 音 模 式 
AudioManager.setRingerMode(AudioManager.RINGER_MODE_NORMAL); 
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// 静 音 模式 
AudioManager.setRingerMode(AudioManager.RINGER_MODE_SILENT); 
// 振 动 模式 
AudioManager.setRingerMode(AudioManager.RINGER_MODE_VIBRATE); 
调整 声音 大 小 
// 减 小 声音 音 
AudioManager.adjustVolume(AudioManager.ADJUST_LOWER, 0); 
// 调 大 声音 音量 
AudioManager.adjustVolume(AudioManager.ADJUST_RAISE, 0); 
(3) 基本 应 
AudioManager 类 的 常见 应 用 如 下 所 示 。 
М ”实现 音量 控制 ， 例 如 下 面 的 代码 。 
/音量 控制 ， 初 始 化 定义 
AudioManager mAudioManager = (AudioManager) getSystemService(Context.AUDIO SERVICE); 
// 最 大 音量 
int maxVolume = mAudioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC); 
// 当 前 音量 
int currentVolume = mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC); 
E) HRA, Im TRI 
if(isSilent){ 
mAudioManager.setStreamVolume(AudioManager.STREAM_MUSIC, 0, 0); 
Jelse( 
mAudioManager.setStreamVolume(AudioManager.STREAM MUSIC, tempVolume, 0); //tempVolume: 
音量 绝对 值 


} 
以 一 步 步 长 控制 音量 的 增 减 ， 并 弹出 系统 默认 音量 控制 条 。 例 如 下 面 的 代码 。 
view sourceprint? 

/降低 音量 ， 调 出 系统 音量 控制 

if(flag == 0){ 


mAudioManager.adjustStreamVolume(AudioManager.STREAM MUSIC,AudioManager.ADJUST LOWER, 
AudioManager.FX FOCUS NAVIGATION UP); 


H 
/增加 音量 ， 调 出 系统 音量 控制 
else if(flag == 1){ 


mAudioManager.adjustStreamVolume(AudioManager.STREAM_MUSIC,AudioManager.ADJUST_RAISE, 
AudioManager.FX FOCUS NAVIGATION UP); 
} 
(4) 调节 声音 的 基本 步 又 
在 Android 系统 中 使 用 AudioManager 类 调节 声音 的 基本 步骤 如 下 。 
© 通过 系统 服务 获得 声音 管理 器 ， 例 如 下 面 的 代码 。 
AudioManager audioManager = (AudioManager)getSystemService(Service.AUDIO_SERVICE); 
@ 根据 实际 需要 调用 适当 的 方法 ， 例 如 下 面 的 代码 。 
audioManager.adjustStreamVolume(int streamType, int direction, int flags); 
上 述 参 数 的 具体 说 明 如 下 所 示 。 
М] streamType: 声音 类 型 ， 可 取 下 面 的 值 。 
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STREAM VOICE CALL: 打 电 话 时 的 声音 。 
STREAM SYSTEM: Android 系统 声音 。 
STREAM RING: 电话 铃 响 。 
STREAM MUSIC: 音乐 声音 。 
> STREAM ALARM: 警告 声音 。 
M direction: 调整 音量 的 方向 ， 可 取 下 面 的 值 。 
> ADJUST LOWER: 调 低音 量 。 
> ADJUST RAISE: 调 高 音 
> ADJUST_SAME: 保持 先前 音量 。 
M flags: 可 选 标志 位 。 
@ 设置 指定 声音 类 型 ， 例 如 下 面 的 代码 。 
audioManager.setStreamMute(int streamType, boolean state) 
通过 上 述 方法 设置 指定 声音 类 型 (streamType) 是 否 为 静音 。 如 果 state 为 tue， 则 设置 为 静音 ; 
否则 ， 不 设置 为 静音 。 
@ 设置 铃 音 模式 ， 例 如 下 面 的 代码 。 
audioManager.setRingerMode(int ringerMode); 
通过 上 述 方法 设置 铃 音 模式 ， 可 取 的 值 如 下 所 示 。 
RINGER MODE NORMAL: 铃 音 正常 模式 。 
RINGER MODE SILENT: 铃 音 静音 模式 。 
RINGER MODE VIBRATE: 铃 音 振动 模式 ， 即 铃 音 为 静音 ， 启 动 振动 。 
© 设置 声音 模式 ， 例 如 下 面 的 代码 。 
audioManager.setMode(int mode); 
通过 上 述 方法 设置 声音 模式 ， 可 取 的 值 如 下 所 示 。 
MODE NORMAL: 正常 模式 ， 即 在 没有 铃 音 与 电话 的 情况 。 
М MODE RINGTONE: 铃 响 模式 。 
MODE IN CALL: 接 通电 话 模 式 。 
MODE_IN COMMUNICATION: 通话 模式 。 


注意 : 声音 的 调节 是 没有 权限 要 求 的 。 
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实例 8-6 设置 短信 提示 铃声 光盘 :\daima\8\LingEX 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 在 文件 main.xml 中 设置 3 个 按钮 ， 分 别 实现 启用 、 停 止 和 设置 间隔 时 间 功 能 。 主 要 代码 如 下 : 


<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:gravity-"center" 
> 

<Button 

android:id="@+id/startButton" 
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android:text="@string/startButton” 
android:layout_width="fill_parent" 
android:layout height-"wrap content" /> 
«Button 
android:id-"(g *id/endButton" 
android:text="@string/endButton" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" /> 
<Button 
android:id="@+id/configButton" 
android:text="@string/configButton" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /> 
</LinearLayout> 
(2) 编写 文件 lingCHService.java, FF — Service 监听 短信 的 事件 ， 在 短信 到 达 后 进行 声音 播 
放 的 处 理 , 牵涉 到 的 主要 是 Service、Broadcast、MediaPlayer 和 Preference。 在 此 包含 了 存放 铃声 的 Map 
和 播放 铃声 等 逻辑 处 理 ， 通 过 AudioManager 来 暂时 打开 多 媒体 声音 ,播放 完 再 关闭 。 文 件 BellService. 
java 的 主要 代码 如 下 : 
public class lingCHService extends Service { 
/监听 事件 
public static final String SMS RECEIVED ACTION = "android.provider.Telephony.SMS RECEIVED"; 
/铃声 序列 
public static final int ONE_SMS = 1; 
public static final int TWO_SMS = 2; 
public static final int THREE_SMS = 3; 
public static final int FOUR_SMS = 4; 
public static final int FIVE_SMS = 5; 


private HashMap<integer, Integer> bellMap;//#473 Map 

private Date lastSMSTime;// 上 条 短信 时 间 

private int currentBell;// 当 前 应 当 播 放 铃 声 

private boolean justStart=true;// 是 否 是 第 一 次 启动 ， 避 免 首次 启动 马上 收 到 短信 和 导致 立即 播放 第 二 条 铃声 的 
情况 

private AudioManager ат; 

private int currentMediaStatus; 

private int currentMediaMax; 


public IBinder onBind(Intent intent) { 
return null; 


} 


@Override 

public void onCreate() { 
super.onCreate(); 
IntentFilter filter = new IntentFilter(); 
filter.addAction(SMS_RECEIVED_ACTION); 
Log.e("COOKIE", "Service start"); 
/注册 监听 
registerReceiver(messageReceiver, filter); 
/初始 化 Map， 根 据 之 后 改进 可 以 替换 其 中 的 铃声 
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bellMap = new HashMap<integer, Integer>(); 
bellMap.put(ONE_SMS, R.raw.holyshit); 
bellMap.put(TWO SMS, R.raw.holydouble); 
bellMap.put(THREE SMS, R.raw.holytriple); 
bellMap.put(FOUR_SMS, R.raw.holyultra); 
bellMap.put(FIVE SMS, R.raw.holyrampage); 
// 当 前 时 间 

lastSMSTime=new Date(System.currentTimeMillis()); 
// 当 前 应 当 播放 的 铃声 ， 初 始 为 1 

/之 后 根据 间隔 判断 ， 若 为 5 分 钟 之 内 则 +1 

// 车 距离 上 一 次 超过 5 分 钟 ， 则 重新 置 为 1 
currentBell=1; 


@Override 
public void onStart(Intent intent, int startld) { 


} 


super.onStart(intent, startld); 


@Override 
public void onDestroy() { 


} 


super.onDestroy(); 

ASAT 
unregisterReceiver(messageReceiver); 
Log.e("COOKIE", "Service end"); 


// 设 定 广播 


private BroadcastReceiver messageReceiver = new BroadcastReceiver() { 


@Override 
public void onReceive(Context context, Intent intent) { 
String action = intent.getAction(); 
if (action.equals(SMS RECEIVED ACTION)) { 
playBell(context, 0); 
} 
} 


E 
// 播 放 音 效 
private void playBell(Context context, int num) { 


/为 防止 用 户 当 前 模式 关闭 了 media 音效 ， 先 将 media 打开 


am=(AudioManager)getSystemService(Context.AUDIO_SERVICE);// 获 取 音量 控制 
currentMediaStatus=am.getStreamVolume(AudioManager.STREAM_MUSIC); 
currentMediaMax=am.getStreamMaxVolume(AudioManager.STREAM_MUSIC); 
am.setStreamVolume(AudioManager.STREAM_MUSIC, currentMediaMax, 0); 


17813 MediaPlayer 进行 播放 


MediaPlayer mp = MediaPlayer.create(context, getBellResource()); 
mp.setOnCompletionListener(new musicCompletionListener()); 


mp.start(); 
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private class musicCompletionListener implements OnCompletionListener { 


@Override 
public void onCompletion(MediaPlayer mp) { 
/播放 结束 释放 mp 资源 
mp.release(); 
/恢复 用 户 之 前 的 media 模式 
am.setStreamVolume(AudioManager.STREAM_MUSIC, currentMediaStatus, 0); 
} 
} 
// 获 取 当 前 应 该 播放 的 铃声 


private int getBellResource() { 
// 判 断 时间 间 隔 (毫秒 ) 
int preferencelnterval; 
long interval; 
Date curTime = new Date(System.currentTimeMillis()); 
interval=curTime.getTime()-lastSMSTime.getTime(); 
lastSMSTime=curTime; 
preferencelnterval-getPreferencelnterval(); 
if(interval«preferencelnterval*60*1000&&ljustStart)( 
currentBell++; 
if(currentBell>5){ 
currentBell=5; 
} 
Jelse( 
currentBell=1; 


} 
justStart=false; 
return bellMap.get(currentBell); 


} 
// 获 取 Preference 设置 
private int getPreferencelnterval()( 
SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(this); 
int interval-Integer.valueOf(settings.getString("interval config", "5")); 
IILog.v(" COOKIE", "interval: "+interval); 
return interval; 
} 
} 
(3) 编写 文件 LingCHActivity.java, 为 屏幕 中 的 3 个 Button 设置 相应 的 处 理事 件 。 主 要 代码 如 下 ; 
public class lingCHService extends Service { 
/监听 事件 
public static final String SMS RECEIVED ACTION - "android.provider.Telephony.SMS RECEIVED"; 
// 铃 声 序列 
public static final int ONE_SMS = 1; 
public static final int TWO_SMS = 2; 
public static final int THREE_SMS = 3; 
public static final int FOUR_SMS = 4; 
public static final int FIVE_SMS = 5; 


private HashMap<integer, Integer> bellMap;//£$ Fs Map 
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private Date lastSMSTime; /上 条 短信 时 间 
private int currentBell; // 当 前 应 当 播 放 铃声 


private boolean justStart=true; // 是 否 是 第 一 次 启动 ， 避 人 免 首 次 启动 马上 收 到 短信 导致 立即 播放 第 二 条 铃声 


的 情况 
private AudioManager ат; 
private int currentMediaStatus; 
private int currentMediaMax; 


public IBinder onBind(Intent intent) { 
return null; 


} 


@Override 

public void onCreate() { 
super.onCreate(); 
IntentFilter filter = new IntentFilter(); 
filter.addAction(SMS_RECEIVED_ACTION); 
Log.e("COOKIE", "Service start"); 
/注册 监听 
registerReceiver(messageReceiver, filter); 
// 初 始 化 Map， 根 据 之 后 改进 可 以 替换 其 中 的 铃声 
bellMap = new HashMap<Integer,Integer>(); 
bellMap.put(ONE_SMS, R.raw.holyshit); 
bellMap.put(TWO_SMS, R.raw.holydouble); 
bellMap.put(THREE_SMS, R.raw.holytriple); 
bellMap.put(FOUR_SMS, R.raw.holyultra); 
bellMap.put(FIVE SMS, R.raw.holyrampage); 
// 当 前 时 间 
lastSMSTime=new Date(System.currentTimeMillis()); 
// 当 前 应 当 播 放 的 铃声 ， 初 始 为 1 
// 之 后 根据 间隔 判断 ， 若 为 5 分 钟 之 内 则 +1 
// 若 距离 上 一 次 超过 5 分 钟 ， 则 重新 置 为 1 
currentBell=1; 


} 


@Override 
public void onStart(Intent intent, int startld) { 
super.onStart(intent, startld); 


} 

@Override 

public void onDestroy() { 
super.onDestroy(); 
/取消 监听 
unregisterReceiver(messageReceiver); 
Log.e("COOKIE", "Service end"); 

} 

// 设 定 广播 


private BroadcastReceiver messageReceiver = new BroadcastReceiver() { 
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@Override 
public void onReceive(Context context, Intent intent) ( 
String action = intent.getAction(); 
if (action.equals(SMS_RECEIVED_ACTION)) ( 
playBell(context, 0); 
i 


Е 

/| 播放 音效 

private void playBell(Context context, int num) { 
/为 防止 用 户 当前 模式 关闭 了 media 音效 ， 先 将 media 打开 
am=(AudioManager)getSystemService(Context.AUDIO_SERVICE);// 获 取 音 量 控制 
currentMediaStatus-am.getStreamVolume(AudioManager.STREAM MUSIC); 
currentMediaMax-am.getStreamMaxVolume(AudioManager.STREAM MUSIC); 
am.setStreamVolume(AudioManager.STREAM MUSIC, currentMediaMax, 0); 
/创建 MediaPlayer 进行 播放 
MediaPlayer mp = MediaPlayer.create(context, getBellResource()); 
mp.setOnCompletionListener(new musicCompletionListener()); 
mp.start(); 

} 


private class musicCompletionListener implements OnCompletionListener { 
@Override 
public void onCompletion(MediaPlayer mp) { 
/播放 结束 释放 mp 资源 
mp.release(); 
/恢复 用 户 之 前 的 media 模式 
am.setStreamVolume(AudioManager.STREAM_MUSIC, currentMediaStatus, 0); 
} 


} 
// 获 取 当 前 应 该 播放 的 铃声 
private int getBellResource() { 
// 判 断 时 间 间 隔 (毫秒 ) 
int preferencelnterval; 
long interval; 
Date curTime = new Date(System.currentTimeMillis()); 
interval=curTime.getTime()-lastSMSTime.getTime(); 
lastSMSTime=curTime; 
preferencelnterval-getPreferencelnterval(); 
if(interval«preferencelnterval*60*1000&&!justStart)( 
currentBell++; 
if(currentBell>5){ 
currentBell=5; 
} 
Jelse( 
currentBell=1; 
} 
justStart=false; 
return bellMap.get(currentBell); 
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/获取 Preference 设置 
private int getPreferencelnterval()( 
SharedPreferences settings = PreferenceManager.getDefaultSharedPreferences(this); 
int interval-Integer.valueOf(settings.getString("interval config", "5")); 
IlLog.v(" COOKIE", "interval: "+interval); 
return interval; 
) 
) 
执行 之 后 在 屏幕 中 单 击 按钮 可 以 设置 对 应 的 铃声 ， 效 果 如 图 8-21 所 示 。 


图 8-21 执行 效果 


86 录音 详解 


GAO 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \ 录 音 详解 .avi 

在 Android 系统 中 ,录制 音频 和 视频 最 常 采 用 的 是 MediaRecorder 接口 。 为 了 录制 音频 文件 ， 需 要 
设置 音频 源 、 输 出 格式 、 录 制 时 间 、 编 码 格式 等 。 类 AudioRecord fE Java 应 用 程序 中 管理 音频 资源 ， 用 
来 记录 从 音频 输入 设备 产生 的 数据 。 通 过 AudioRecord 对 象 来 完成 “pulling”( 读 取 ) 数据 。 通 过 以 
下 几 个 方法 立即 从 AudioRecord 对 象 读 取 : read(byte[],int,int)、read(short[],int,int) 或 read(ByteBuffer, 
int)。 无 论 使 用 哪 种 音频 格式 ， 使 用 AudioRecord 是 最 方便 的 。 本 节 将 详细 讲解 在 Android 系统 中 实现 
录音 功能 的 方法 。 


8.6.1 ”使 用 MediaRecorder 接口 录制 音频 


在 创建 AudioRecord 对 象 时 ，AudioRecord 会 初始 化 ， 并 和 音频 缓冲 区 连接 ,用 来 缓冲 新 的 音频 数 
据 。 根 据 构造 时 指定 的 缓冲 区 大 小 ， 来 决定 AudioRecord 能 够 记录 多 长 的 数据 。 从 硬件 设备 读 取 的 数 
据 应 小 于 整个 记录 缓冲 区 。 
MediaRecorder 的 内 部 类 是 AudioRecord.OnRecordPositionUpdateListener, “4 AudioRecord 收 到 一 
个 由 setNotificationMarkerPosition(int) 设 置 的 通知 标志 ， 或 由 setPositionNotificationPeriod(int) 设 置 的 周 
期 更 新 记录 的 进度 状态 时 ， 回 调 此 接口 。 
(1) 常量 
MediaRecorder 中 常用 常量 如 下 所 示 。 
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public static final int ERROR: 表示 操作 失败 ， 常 量 值 : -1(Oxfffffffp) 。 

public static final int ERROR BAD VALUE: 表示 使 用 了 一 个 不 合理 的 值 导致 的 失败 ， 常 量 
为 -2(Oxfffffffe) o 

public static final int ERROR INVALID OPERATION: 表示 不 恰当 的 方法 导致 的 失败 ， 常 量 
为 -3(Oxfffffffd) . 

public static final int RECORDSTATE RECORDING: 指示 AudioRecord 录制 状态 为 “正在 录 
ШШ”, 常量 值 为 3(0x00000003)。 

public static final int RECORDSTATE STOPPED: 指示 AudioRecord 录制 状态 为 “不 在 录制 ” 
常量 值 为 1(0x00000001)。 

public static final int STATE_INITIALIZED: 指示 AudioRecord 准备 就 绪 , 常量 值 为 1(0x00000001)。 
public static final int STATE_UNINITIALIZED: 指示 AudioRecord 状态 没有 初始 化 成 功 ， 常 量 
值 为 0(0x00000000)。 

public static final int SUCCESS: 表示 操作 成 功 ， 常 量 值 为 0(0x00000000)。 


(2) 构造 函数 
MediaRecorder 中 的 构造 函数 是 AudioRecord， 具 体格 式 如 下 : 
public AudioRecord(int audioSource, int sampleRatelnHz, int channelConfig, int audioFormat, int buffer SizelnBytes) 
各 个 参数 的 具体 说 明 如 下 。 


audioSource: 录制 源 。 

sampleRateInHz: 默认 采样 率 ， 单 位 为 Hz。44100Hz 是 当前 唯一 能 保证 在 所 有 设备 上 工作 的 
采样 率 ， 在 一 些 设备 上 还 有 22050. 16000 或 11025. 

channelConfig: 描述 音频 通道 设置 。 

audioFormat: 音频 数据 保证 支持 此 格式 。 

bufferSizeInBytes: 在 录制 过 程 中 ,音频 数据 写 入 缓冲 区 的 总 数 ( 字 节 )。 从 缓冲 区 读 取 的 新 音 
频数 据 总 会 小 于 此 值 。getMinBufferSize(int,int,int) 会 返回 AudioRecord 实例 创建 成 功 后 的 最 小 
缓冲 区 。 设 置 的 值 比 getMinBufferSize0 还 小 则 会 导致 初始 化 失败 。 


(3) 公共 方法 
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public int getAudioFormat(): 返回 设置 的 音频 数据 格式 。 

public int getAudioSource(): 返回 音频 录制 源 。 

public int getChannelConfiguration0: 返回 设置 的 频道 设置 。 请 参见 CHANNEL IN МОМО 和 
CHANNEL IN STEREO. 

public int getChannelCount(): 返回 设置 的 频道 数目 。 

public static int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat): 返回 
成 功 创建 AudioRecord 对 象 所 需要 的 最 小 缓冲 区 大 小 。 其 参数 介绍 如 下 。 

>  sampleRateInHz: 默认 采样 率 ， 单 位 为 Hz。 

>  channelConfig: 描述 音频 通道 设置 。 

>  audioFormat: 音频 数据 保证 支持 此 格式 。 


如 果 硬 件 不 支持 录制 参数 ， 或 输入 了 一 个 无 效 的 参数 ， 则 返回 ERROR_BAD_VALUE， 如 果 硬 件 
查询 到 输出 属性 没有 实现 ， 或 最 小 缓冲 区 用 byte 表示 ， 则 返回 ERROR. 
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注意 : 这 个 大 小 并 不 保证 在 负荷 下 的 流畅 录制 ， 应 根据 预期 的 频率 来 选择 更 高 的 值 ， AudioRecord 实例 
在 推送 新 数据 时 使 用 此 值 。 


public int getNotificationMarkerPosition0: 返回 通知 ， 标 记 框架 中 的 位 置 。 

public int getPositionNotificationPeriod(): 返回 通知 ， 更 新 框架 中 的 时 间 位 置 。 

public int getRecordingState0: 返回 AudioRecord 实例 的 录制 状态 。 

public int getSampleRate(): 返回 设置 的 音频 数据 样本 采样 率 ， 单 位 为 Hz。 

public int getState(): 返回 AudioRecord 实例 的 状态 。 这 点 非常 有 用 ， 用 在 AudioRecord 实例 
创建 成 功 后 ， 检 查 初始 化 属性 。 

public int read(short[] audioData, int offsetInShorts, int sizeInShorts): 从 音频 硬件 录制 缓冲 区 读 取 
数据 。 上述 参 数 的 具体 说 明 如 下 所 示 。 

»  audioData: 写 入 的 音频 录制 数据 。 

>  offsetInShorts: 目标 数组 audioData 的 起 始 偏 移 量 。 

>  sizelnShorts : 请 求 读 取 的 数据 大 小 。 

返回 值 是 一 个 short 型 数据 ， 表 示 读 取 到 的 数据 ， 如 果 对 象 属性 没有 初始 化 ， 则 返回 ERROR_ 
INVALID OPERATION; 如 果 参 数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR BAD VALUE. Ж 
回 数值 不 会 超过 sizeInShorts。 

М public int read(byte[] audioData, int offsetInBytes, int sizeInBytes): 从 音频 硬件 录制 缓冲 区 读 取 

数据 。 

>  audioData: 写 入 的 音频 录制 数据 。 

>  offsetlnBytes: audioData 的 起 始 偏 移 值 ， 单 位 为 byte。 
>  sizelnBytes: 读 取 的 最 大 字 节 数 。 

返回 值 是 读 入 缓冲 区 的 总 byte 数 ， 如 果 对 象 属性 没有 初始 化 ， 则 返回 ERROR_INVALID_ 
OPERATION; 如 果 参 数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR_BAD_VALUE。 读 取 的 总 byte 
数 不 会 超过 sizeInBytes。 

М public int read(ByteBuffer audioBuffer, int sizeInBytes): 从 音频 硬件 录制 缓冲 区 读 取 数 据 ， 直 接 

复制 到 指定 缓冲 区 。 如 果 audioBuffer 不 是 直接 的 缓冲 区 ， 此 方法 总 是 返回 0。 上 述 参数 的 具 
体 说 明 如 下 所 示 。 

>  audioBuffer: 存储 写 入 音频 录制 数据 的 缓冲 区 。 

>  sizelnBytes: 请 求 的 最 大 字 节 数 。 

返回 值 是 读 入 缓冲 区 的 总 byte 数 ， 如 果 对 象 属性 没有 初始 化 ， 则 返回 ERROR_INVALID_ 
OPERATION; 如 果 参 数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR BAD VALUE。 读 取 的 总 byte 
数 不 会 超过 sizeInBytes。 

М public void release): 释放 本 地 AudioRecord 资源 。 一 般 对 象 不 能 经 常 使 用 此 方法 ， 而 且 在 调 

用 release0 后 ， 必 须 设置 引用 为 null。 

М public int setNotificationMarkerPosition(int markerInFrames): 如 果 设 置 了 setRecordPosition Update 
Listener(OnRecordPositionUpdateListener) 或 setRecordPositionUpdateListener(OnRecord Position 
UpdateListener, Handler)， 则 通知 监听 者 设置 位 置 标记 。 参 数 markerInFrames 表示 在 框架 中 快 
速 标记 位 置 ， 返 回 值 是 返回 错误 或 成 功 代码 。 
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public int setPositionNotificationPeriod(int periodInFrames): 如 果 设 置 了 setRecordPosition Update 
Listener(OnRecordPositionUpdateListener) 或 setRecordPositionUpdateListener(OnRecord Position 
UpdateListener, Handler)， 则 通知 监听 者 设置 时 间 标记 。 参 数 markerInFrames 表示 在 框架 中 快 
速 更 新 时 间 标 记 ， 返 回 值 是 返回 错误 或 成 功 代码 ， 请 参见 SUCCESS 和 ERROR 
INVALID OPERATION. 

public void setRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener, 
Handler handler): 当 之 前 设置 的 标志 已 经 成 立 ， 或 者 周期 录制 位 置 更 新 时 ， 设 置 处 理 监听 者 。 
使 用 此 方法 将 Handler 和 其 他 的 线程 联系 起 来 来 接收 AudioRecord 事件 ， 比 创建 AudioTrack 
实例 更 好 一 些 。 参 数 handler 用 来 接收 事件 通知 消息 。 

public void setRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener): 
当 之 前 设置 的 标志 已 经 成 立 ， 或 者 周期 录制 位 置 更 新 时 ， 设 置 处 理 监听 者 。 

public void startRecording(): AudioRecord 实例 开始 进行 录制 。 


4. 受 保护 方法 


AudioRecord 中 的 受 保护 方法 是 protected void finalize()， 用 于 通知 УМ 回收 此 对 象 内 存 。 方 法 
finalizeO 只 能 用 在 运行 的 应 用 程序 没有 任何 线程 再 使 用 此 对 象 , 来 告诉 垃圾 回收 器 回收 此 对 象 。 此 方法 
用 于 释放 系统 资源 ， 由 垃圾 回收 器 清除 此 对 象 。 默认 没有 实现 ， 由 VM 来 决定 ， 但 子 类 根据 需要 可 重 
写 finalize0。 在 执行 期 间 ， 调 用 此 方法 可 能 会 立即 抛 出 未 定义 异常 ， 但 是 可 以 忽略 。 
注意 : VM 保证 对 象 可 以 一 次 或 多 次 调用 finalize()， 但 并 不 保证 finalize0 会 马上 执行 。 例如， 对 象 B 

的 finalize() 可 能 延迟 执行 ， 等 待 对 象 A 的 finalize0 延 迟 回收 A 的 内 存 。 为 了 安全 起 见 ， 请 查看 
ReferenceQueue， 在 它 里 面 提供 了 更 多 的 控制 VM 的 垃圾 回收 。 


8.6.2 ”使 用 AudioRecord 接口 录音 


类 AudioRecord 在 Java 应 用 程序 中 管理 音频 资源 ， 用 来 记录 从 平台 音频 输入 设备 产生 的 数据 。 通 
过 AudioRecord 对 象 来 完成 “pulling”( 读 取 ) 数据 。 通 过 以 下 几 个 方法 负责 立即 从 AudioRecord 对 象 
读 取 : read(byte[]. int, int), read(short[], int, int)&& read(ByteBuffer, inb。 无 论 使 用 哪 种 音频 格式 ， 使 用 
AudioRecord 是 最 方便 的 。 
在 创建 AudioRecord 对 象 时 ，AudioRecord 会 初始 化 ， 并 和 音频 缓冲 区 连接 ， 用 来 缓冲 新 的 音频 数 
据 。 根 据 构 造 时 指定 的 缓冲 区 大 小 ， 来 决定 AudioRecord 能 够 记录 多 长 的 数据 。 从 硬件 设备 读 取 的 数 
据 应 小 于 整个 记录 缓冲 区 。 
(1) 常量 
AudioRecord 中 包含 的 常量 如 下 所 示 。 
public static final int ERROR: 表示 操作 失败 ， 常 量 值 为 -1(Oxfffffffp 。 
public static final int ERROR BAD VALUE: 表示 使 用 了 一 个 不 合理 的 值 导致 的 失败 ， 常 量 值 
为 -2(Oxfffffffe) . 
回 public static final int ERROR INVALID OPERATION: 表示 不 恰当 的 方法 导致 的 失败 ， 常 量 
为 -3(Oxfffffffd)。 
回 public static final int RECORDSTATE RECORDING: 指示 AudioRecord 录制 状态 为 “正在 录 
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制 ” 常量 值 为 3(0x00000003)。 
public static final int RECORDSTATE_STOPPED: 指示 AudioRecord 录制 状态 为 “不 在 录制 ” 
常量 值 为 1(0x00000001)。 
public static final int STATE_INITIALIZED: 指示 AudioRecord 准备 就 绪 , 常量 值 为 1(0x00000001)。 
public static final int STATE_UNINITIALIZED: 指示 AudioRecord 状态 没有 初始 化 成 功 ， 常 量 
值 为 0(0x00000000).. 
public static final int SUCCESS: 表示 操作 成 功 ， 常 量 值 为 0(0x00000000)。 
(2) 构造 函数 
AudioRecord 中 的 构造 函数 是 AudioRecord， 格 式 如 下 : 
public AudioRecord (int audioSource, int sampleRatelnHz, int channelConfig, int audioFormat, int buffer SizelnBytes) 
各 个 参数 的 具体 说 明 如 下 所 示 。 
audioSource: 录制 源 。 
sampleRateInHz: 默认 采样 率 ， 单 位 为 Hz。44100Hz 是 当前 唯一 能 保证 在 所 有 设备 上 工作 的 
采样 率 ， 在 一 些 设备 上 还 有 22050. 16000 或 11025。 
channelConfig: 描述 音频 通道 设置 。 
audioFormat: 音频 数据 保证 支持 此 格式 。 
bufferSizeInBytes: 在 录制 过 程 中 ,音频 数据 写 入 缓冲 区 的 总 数字 节 )。 从 缓冲 区 读 取 的 新 音 
频数 据 总 会 小 于 此 值 。 用 getMinBufferSize(int, їшї, int) 返 回 AudioRecord 实例 创建 成 功 后 的 最 
小 缓冲 区 ， 如 果 其 设置 的 值 比 getMinBufferSizeO 还 小 则 会 导致 初始 化 失败 。 
(3) 公共 方法 
AudioRecord 中 的 公共 方法 如 下 所 示 。 
М public int getAudioFormat(): 返回 设置 的 音频 数据 格式 。 参 见 ENCODING PCM 16BIT 和 
ENCODING PCM 8ВІТ. 
М public int getAudioSource(): 返回 音频 录制 源 。 
回 public int getChannelConfiguration0: 返回 设置 的 频道 设置 。 参 见 CHANNEL IN MONO 和 
CHANNEL IN STEREO. 
E] public int getChannelCount(: 返回 设置 的 频道 数目 。 
回 public static int getMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat): 返回 
成 功 创建 AudioRecord 对 象 所 需要 的 最 小 缓冲 区 大 小 。 需 要 注意 的 是 ， 这 个 大 小 并 不 能 保证 
在 负荷 下 的 流畅 录制 , 应 根据 预期 的 频率 来 选择 更 高 的 值 ， AudioRecord 实例 在 推送 新 数据 时 
使 用 此 值 。 
上 述 参 数 的 具体 说 明 如 下 所 示 。 
E] sampleRateInHz: 默认 采样 率 ， 单 位 为 Hz. 
M channelConfig: 描述 音频 通道 设置 。 
audioFormat: 音频 数据 保证 支持 此 格式 。 参 见 ENCODING PCM 16BIT. 
如 果 硬件 不 支持 录制 参数 ， 或 输入 了 一 个 无 效 的 参数 ， 则 返回 ERROR BAD VALUE, mR 
查询 到 输出 属性 没有 实现 ， 或 最 小 缓冲 区 用 byte 表示 ， 则 返回 ERROR. 
М public int getNotificationMarkerPosition0: 返回 通知 ， 标 记 框 架 中 的 位 置 。 
public int getPositionNotificationPeriod(): 返回 通知 ， 更 新 框架 中 的 时 间 位 置 。 
回 public int getRecordingState0: 返回 AudioRecord 实例 的 录制 状态 。 
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public int getSampleRate(): 返回 设置 的 音频 数据 样本 采样 率 ， 单 位 为 Hz。 
public int getState(): 返回 AudioRecord 实例 的 状态 。 用 在 AudioRecord 实例 创建 成 功 后 , 检查 
初始 化 属性 。 它 能 肯定 请 求 到 了 合适 的 硬件 资源 。 
public int read(short[] audioData, int offsetInShorts, int sizeInShorts): 从 音频 硬件 录制 缓冲 区 读 取 
数据 。 上 述 参数 的 具体 说 明 如 下 所 示 。 
»  audioData: 写 入 的 音频 录制 数据 。 
>  offsetInShorts: 目标 数组 audioData 的 起 始 偏 移 量 。 
> sizeInShorts: 请 求 读 取 的 数据 大 小 。 
返回 值 是 short 型 数据 , 表示 读 取 到 的 数据 , 如 果 对 象 属性 没有 初始 化 , 则 返回 ERROR_INVALID_ 
OPERATION; 如 果 参 数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR BAD _ VALUE。 返回 数值 不 会 
超过 sizeInShorts。 
public int read(byte[] audioData, int offsetInBytes, int sizeInBytes): 从 音频 硬件 录制 缓冲 区 读 取 
数据 。 上 述 参 数 的 具体 说 明 如 下 所 示 。 
> audioData: 写 入 的 音频 录制 数据 。 
>  offsetInBytes: audioData 的 起 始 偏 移 值 ， 单 位 为 byte。 
>  sizelnBytes: 读 取 的 最 大 字 节 数 。 
读 入 缓冲 区 的 总 byte 数 ， 如 果 对 象 属性 没有 初始 化 , 则 返回 ERROR INVALID OPERATION; 如 果 参 
数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR BAD VALUE。 读 取 的 总 byte 数 不 会 超过 sizeInBytes。 
public int read(ByteBuffer audioBuffer, int sizeInBytes): 从 音频 硬件 录制 缓冲 区 读 取 数 据 ， 直 接 
复制 到 指定 缓冲 区 。 如 果 audioBuffer 不 是 直接 的 缓冲 区 ， 此 方法 总 是 返回 0。 上 述 参 数 的 具 
体 说 明 如 下 所 示 。 
> audioBuffer: 存储 写 入 音频 录制 数据 的 缓冲 区 。 
>  sizelnBytes: 请 求 的 最 大 字 节 数 。 
读 入 缓冲 区 的 总 byte 数 ， 如 果 对 象 属性 没有 初始 化 , 则 返回 ERROR INVALID OPERATION; 如 果 参 
数 不 能 解析 成 有 效 的 数据 或 索引 ， 则 返回 ERROR BAD VALUE。 读 取 的 总 byte 数 不 会 超过 sizeMBytes. 
public void release(): 释放 本 地 AudioRecord 资源 .对 象 不 能 经 常 使 用 此 方法 , 而且 在 调用 release0 
后 ， 必 须 设 置 引 用 为 null。 
public int setNotificationMarkerPosition(int markerInFrames): 如 果 设 置 了 setRecordPosition Update 
Listener(OnRecordPositionUpdateListener) 或 setRecordPositionUpdate Listener(OnRecordPosition 
UpdateListener, Handler)， 则 通知 监听 者 设置 位 置 标记 。 参 数 markerInFrames 表示 在 框架 中 快 
速 标记 位 置 。 
public int setPositionNotificationPeriod(int periodInFrames): 如 果 设 置 了 setRecordPositionUpdate 
Listener(OnRecordPositionUpdateListener) PX setRecordPositionUpdateListener(OnRecordPosition 
UpdateListener, Handler)， 则 通知 监听 者 设置 时 间 标 记 。 参 数 markerInFrames 表示 在 框架 中 快 
速 更 新 时 间 标 记 。 
public void setRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener, 
Handler handler): 当 之 前 设置 的 标志 已 经 成 立 ， 或 者 周期 录制 位 置 更 新 时 ， 设 置 处 理 监听 者 。 
使 用 此 方法 将 Handler 和 其 他 的 线程 联系 起 来 来 接收 AudioRecord 事件 ， 比 创建 AudioTrack 
实例 更 好 一 些 。 参 数 handler 用 来 接收 事件 通知 消息 。 
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public void setRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener): 
当 之 前 设置 的 标志 已 经 成 立 ， 或 者 周期 录制 位 置 更 新 时 ， 设 置 处 理 监听 者 。 
public void startRecording0: 表示 AudioRecord 实例 开始 进行 录制 。 
(4) 受 保护 方法 
在 AudioRecord 中 受 保 护 方法 是 protected void finalize0， 此 方法 用 于 通知 УМ 回收 此 对 象 内 存 。 
只 能 被 用 在 运行 的 应 用 程序 没有 任何 线程 再 使 用 此 对 象 ， 来 告诉 垃圾 回收 器 回收 此 对 象 。 
方法 finalize0 用 于 释放 系统 资源 ， 由 垃圾 回收 器 清除 此 对 象 。 默 认 没 有 实现 ， 由 VM 来 决定 ， 但 
子 类 根据 需要 可 重 写 fmalize0。 在 执行 期 间 ， 调 用 此 方法 可 能 会 立即 抛 出 未 定义 异常 ， 但 是 可 以 忽略 。 
注意 : VM 保证 对 象 可 以 一 次 或 多 次 调用 finalize0)， 但 并 不 保证 finalize0 会 马上 执行 。 例 如 ， 对象 В 
的 finalizeO 可 能 延迟 执行 ,等待 对 象 A 的 finalize0 延 迟 回收 A 的 内 存 。 为 了 安全 起 见 ， 请 查看 
ReferenceQueue， 它 提供 了 更 多 的 控制 VM 的 垃圾 回收 。 
另外 , BRA Activity 的 线程 中 创建 AudioRecord 对 象 ， 可 以 在 独立 的 线程 中 读 取 数据 ,否则 像 
华为 U8800 之 类 手机 录音 时 会 出 错 。 


8.7 在 物 联 网 设备 中 播放 音乐 


Фин 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \ 在 物 联 网 设备 中 播放 音乐 .avi 
在 整个 手机 体系 中 ， 播 放 音频 功能 才 是 真正 的 核心 ， 例 如 MP3 播放 。 本 节 将 详细 讲解 在 Android 
物 联 网 设备 中 播放 音乐 的 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


8.7.1 使 用 AudioTrack 播放 音频 


要 想 学 好 AudioTrack API， 读 者 可 以 从 分 析 Android 源码 中 的 Java 源码 做 起 。 其 具体 代码 如 下 。 
/根据 采样 率 、 采 样 精度 和 单 双 声 道 来 取得 frame 的 大 小 


int bufsize = AudioTrack.getMinBufferSize(8000, /每 秒 8K 个 点 

AudioFormat.CHANNEL_CONFIGURATION_STEREO, 1// 双 声 道 
AudioFormat.ENCODING_PCM_16BIT): /一 个 采样 点 16 比特 -2 个 字 节 
/创建 AudioTrack 


AudioTrack trackplayer = new AudioTrack(AudioManager.STREAM_MUSIC, 8000, 
AudioFormat.CHANNEL_CONFIGURATION_ STEREO, 
AudioFormat.ENCODING_PCM_16BIT, 


bufsize, 
AudioTrack. MODE. STREAM); 
trackplayer.play() ; FRE 
trackplayer.write(bytes pkg, 0, bytes pkg.length) ; /向 track 中 写 数据 
trackplayer.stop(); /停止 播放 
trackplayer.release(); /释放 底层 资源 


在 上 述 AudioTrack 代码 中 ， 有 MODE STATIC 和 MODE STREAM 两 种 分 类 。STREAM 的 意思 
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是 由 用 户 在 应 用 程序 通过 write CE). 方式 把 数据 一 次 一 次 地 写 到 AudioTrack 中 。 这 个 和 在 Socket 中 
发 送 数据 一 样 , 应 用 层 从 某 个 地 方 获取 数据 , 例如 通过 编 /解码 得 到 РСМ 数据 , 然后 写 入 到 AudioTrack。 
这 种 方式 的 坏处 就 是 总 是 在 Java 层 和 Native 层 交 互 ， 效 率 损 失 较 大 。 

而 STATIC 的 意思 是 一 开始 创建 时 就 把 音频 数据 放 到 一 个 固定 的 buffer， 然 后 直接 传 给 AudioTrack, 
后 续 就 不 用 一 次 次 地 write 了 。AudioTrack 会 自己 播放 这 个 buffer 中 的 数据 。 这 种 方法 对 于 铃声 等 内 存 
占用 较 小 、 延 时 要 求 较 高 的 声音 来 说 很 适用 。 


8.7.2 ”使 用 MediaPlayer 播放 音频 


MediaPlayer 的 功能 比较 强大 , 不 但 可 以 播放 音频 , 而 且 可 以 播放 视频 , 并 且 还 可 以 通过 VideoView 
播放 视频 。 和 VideoView 相 比 ，MediaPlayer 的 优点 非常 多 ， 例 如 简单 易 用 。 但 是 MediaPlayer 也 不 是 
万 能 的 ， 也 有 缺点 一 一 播放 视频 时 需要 SurfaceView 帮忙 。 但 是 总 体 来 说 ，SurfaceView 比 普通 的 自 定 
义 View 更 有 绘图 上 的 优势 ， 它 支持 完全 的 OpenGL ES 库 。 

MediaPlayer 能 被 用 来 控制 音频 /视频 文件 或 流 媒体 的 回放 , 可 以 在 VideoView 中 找到 关于 如 何 使 
这 个 类 中 的 方法 的 例子 。 使 用 MediaPlayer 实现 音频 /视频 播放 的 基本 步骤 如 下 : 

(1) ÆR MediaPlayer 对 象 ， 根 据 播放 文件 从 不 同 的 地 方 使 用 不 同 的 生成 方式 (参考 MediaPlayer 
АРІ 即 可 )。 
(2) 得 到 MediaPlayer 对 象 后 ， 根 据 实际 需要 调用 不 同 的 方法 ， 如 start0、stop0、pause0 和 releaseQ^5 

读者 需要 注意 的 是 , 在 不 需要 播放 时 要 及 时 释放 掉 与 MediaPlayer 对 象 相连 接 的 播放 文件 ， 因 为 直 
接 使 用 MediaPlayer 对 象 一 般 都 是 进行 音频 播放 。 


8.7.8 ”使 用 SoundPool 播放 音频 


SoundPool 在 Android 系统 中 的 地 位 一 般 , 但 是 Android 还 偏偏 离 不 开 这 种 类 型 ,原因 是 MediaPlayer 
适合 播放 长 点 的 音频 。 而 SoundPool 能 够 播放 一 些 短 的 反应 速度 要 求 高 的 声音 ， 如 游戏 中 的 爆破 声 。 
正 是 这 一 功能 ， 所 以 SoundPool 被 保留 了 下 来 。 


1. 主要 特点 


(1) SoundPool 使 用 了 独立 的 线程 来 载 入 音乐 文件 ， 不 会 阻塞 UI 主线 程 的 操作 。 但 是 这 里 如 果 音 
效 文件 过 大 没有 载 入 完成 ， 调 用 play0 方 法 时 可 能 产生 严重 的 后 果 ， 这 里 Android SDK 提供 了 一 个 
SoundPool.OnLoadCompleteListener 类 来 帮助 我 们 了 解 媒体 文件 是 否 载 入 完成 ， 重 载 onLoadComplete 
(SoundPool soundPool, int sampleld, int status) 方 法 即 可 获得 。 

(2) 从 上 面 的 onLoadComplete() 方 法 可 以 看 出 该 类 有 很 多 参数 ， 例 如 类 似 id, SoundPool fE load 
时 可 以 处 理 多 个 媒体 一 次 初始 化 并 放 入 内 存 中 ， 这 里 效率 比 MediaPlayer 高 了 很 多 。 

(3) SoundPool 类 支持 同时 播放 多 个 音效 ， 这 对 于 游戏 来 说 是 十 分 必要 的 ， 而 MediaPlayer 类 是 同 
步 执行 的 ， 只 能 一 个 文件 一 个 文件 地 播放 。 


2. 载 入 音效 的 方法 


回 int load(Context context, int resId, int priority): 从 АРК 资源 载 入 。 
回 int load(FileDescriptor fd, long offset, long length, int priority): 从 FileDescriptor 对 象 载 入 。 
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int load(AssetFileDescriptor afd, int priority): 从 Asset 对 象 载 入 。 
回 intload(String path, int priority): 从 完整 文件 路 径 名 载 入 。 


8.8 为 物 联 网 设备 实现 振动 功能 
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无 论 是 智能 手机 还 是 普通 手机 ， 几 乎 每 一 款 手机 都 具备 振动 功能 。 在 Android 系统 中 ， 振 动 功能 
是 通过 类 Vibrator 实现 的 , 读者 可 以 在 SDK 中 的 android.os. Vibrator 找到 相关 的 描述 。 振 动 方法 的 语法 
格式 如 下 : 

vibrate(long[] pattern, int repeat) 

long[] pattern: 是 一 个 节奏 数组 ， 如 {1, 200}. 

М repeat: 是 重复 次 数 ，-1 为 不 重复 ,而 数字 直接 表示 的 是 具体 的 数字 ， 和 一 般 -1 表示 无 限 不 同 。 

在 使 用 振动 功能 之 前 ， 需 要 先 在 manifest 中 加 入 下 面 的 权限 。 


<uses-permission android:name="android.permission.VIBRATE"/> 

在 设置 振动 (Vibration) 事件 时 ， 必 须要 知道 命令 其 振动 的 时 间 长 短 、 振 动 事件 的 周期 等 。 因 为 在 
Android 中 设置 的 数值 都 是 以 毫秒 〈1000 毫秒 =1 Ж) 来 做 计算 的 ， 所 以 在 做 设置 时 ， 必 须要 注意 设置 
时 间 的 长 短 ， 如 果 设 置 的 时 间 值 太 小 ， 会 感觉 不 出 来 。 

要 让 手机 振动 ， 需 创建 Vibrator 对 象 ， 通 过 调用 vibrate() 方 法 来 达到 振动 的 目的 ， 在 Vibrator 的 构 
造 器 中 有 4 个 参数 ， 前 3 个 的 值 是 设置 振动 的 大 小 ， 可 以 把 数值 改 成 一 大 一 小 ， 这 样 就 可 以 明显 感觉 
出 振动 的 差异 ， 而 最 后 一 个 值 是 设置 振动 的 时 间 。 

在 Android 系统 中 ， 开 发 振动 应 用 程序 的 基本 流程 如 下 所 示 。 

(1) 在 manifest 文件 中 声明 振动 权限 。 
(2) 通过 系统 服务 获得 手机 振动 服务 ， 例 如 下 面 的 代码 。 
Vibrator vibrator = (Vibrator)getSystemService(VIBRATOR_SERVICE); 
(3) 得 到 振动 服务 后 检测 vibrator 是 否 存在 ， 例 如 下 面 的 代码 。 
vibrator.hasVibrator(); 
通过 上 述 代 码 可 以 检测 当前 硬件 是 否 有 vibrator， 如 果 有 ， 返 回 tue， 如 果 没 有 ， 返 回 false. 
(4) 根据 实际 需要 进行 适当 的 调用 ， 例 如 下 面 的 代码 。 
vibrator.vibrate(long milliseconds); 
通过 上 述 代 码 开始 启动 vibrator 持续 milliseconds 毫秒 。 
(5) 编写 下 面 的 代码 。 

vibrator.vibrate(long[] pattern, int repeat); 

XX FÉ UJ pattern 方式 重复 repeat 次 启动 vibrator. pattern 的 形式 如 下 : 

new long[]{arg1,arg2,arg3,arg4......} 

在 上 述 格式 中 ， 其 中 以 两 个 一 组 的 如 argl 和 arg2 为 一 组 、arg3 和 arg4 为 一 组 ， 每 一 组 的 前 一 个 
代表 等 待 多 少 毫 秒 启 动 vibrator， 后 一 个 代表 vibrator 持续 多 少 毫秒 停止 , 之 后 往复 即 可 。repeat KRE 
复 次 数 ， 当 其 为 -1 时 ， 表 示 不 重复 只 以 pattem 的 方式 运行 一 次 。 

(6) 停止 振动 ， 代 码 如 下 。 


vibrator.cancel(); 
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Фи 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 8 章 \ 实 战 闹钟 功能 .avi 
fE Android 系统 中 是 通过 AlarmManage 实现 闹钟 功能 的 ， 对 应 AlarmManage 有 一 个 


AlarmManagerServie 服务 程序 ， 该 服务 程序 才 是 真正 提供 闹 铃 服务 的 ， 它 主要 维护 应 用 程序 注册 下 来 
的 各 类 阔 铃 并 适时 设置 即将 触发 的 闹 铃 给 亲人 铃 设 备 。 在 Android 系统 中 ，Linux 实现 的 设备 名 为 
“/dev/alarm”， 并 且 一 直 监 听闻 铃 设备 ， 一 旦 有 逆 铃 触发 或 者 是 闸 铃 事件 发 生 ，AlarmManagerServie 
服务 程序 就 会 遍历 闹 铃 列表 找到 相应 的 注册 疗 铃 并 发 出 广播 。 该 服务 程序 在 系统 启动 时 被 系统 服务 程 
№ System service 启动 并 初始 化 闹 铃 设备 〈/devwalarm)。 当 然 ， 在 Java 层 的 AlarmManagerService 与 
Linux Alarm 驱动 程序 接口 之 间 还 有 一 层 封装 ， 那 就 是 ЛП. 


AlarmManager 将 应 用 与 服务 分 割 开 来 后 ， 使 得 应 用 程序 开发 者 不 用 关心 具体 的 服务 ， 而 是 直接 通 


过 AlarmManager 来 使 用 这 种 服务 ,AlarmManager 与 AlarmManagerServie 之 间 是 通过 Binder 来 通信 的 ， 
它们 之 间 是 多 对 一 的 关系 。 


330 


在 Android 系统 中 ，AlarmManage 提供 了 3 个 接口 5 种 类 型 的 闹 铃 服务 。 其 中 3 个 接口 如 下 所 示 。 
// 取 消 已 经 注册 的 与 参数 匹配 的 闵 铃 

void cancel(PendingIntent operation) 

/注册 一 个 新 的 闹 铃 

void set( int type, long triggerAtTime, Pendinglntent operation) 

/注册 一 个 重复 类 型 的 闵 铃 

void setRepeating( int type, long triggerAtTime, long interval, Pendinglntent operation) 

IENE 

void setTimeZone(String timeZone) 

5 ARRA FR o 

public static final int ELAPSED_REALTIME 

// 当 系统 进入 睡眠 状态 时 ， 这 种 类 型 的 闹 铃 不 会 唤醒 系统 。 直 到 系统 下 次 被 唤醒 才 传 递 它 ， 该 闹 铃 所 用 的 时 间 是 相 
对 时 间 ， 是 从 系统 启动 后 开始 计时 的 ， 包 括 睡眠 时 间 ， 可 以 通过 调用 SystemClock.elapsedRealtime() 获 得 。 系 统 
值 是 3(0x00000003) 

public static final int ELAPSED_REALTIME_WAKEUP 

// 能 唤醒 系统 ， 用 法 同 ELAPSED_REALTIME, tÆ 2(0x00000002) 

public static final int RTC 


// 当 系统 进入 睡眠 状态 时 ， 这 种 类 型 的 闹 铃 不 会 唤醒 系统 。 直 到 系统 下 次 被 唤醒 才 传 递 它 ， 该 闵 铃 所 用 的 时 间 是 绝 
对 时 间 ， 所 用 时 间 是 UTC 时 间 ， 可 以 通过 调用 System.currentTimeMillis() 获 得 。 系 统 值 是 1(0x00000001) 
public static final int RTC_WAKEUP 
/能 唤醒 系统 ， 用 法 同 RTC 类 型 ， 系 统 值 为 0(0x00000000) 
Public static final int POWER_OFF_WAKEUP 
/能 唤醒 系统 ， 它 是 一 种 关机 闹 铃 ， 就 是 说 设备 在 关机 状态 下 也 可 以 唤醒 系统 ， 所 以 把 它 称 之 为 关机 闹 铃 。 使 用 方 
法 同 RTC 类 型 ， 系 统 值 为 4(0x00000004) 
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Map 地 图 对 大 家 来 说 应 该 不 算 陌 生 ， 谷 歌 地 图 更 是 名 扬 大 地 ， 被 广泛 用 于 商业 、 民 用 和 军用 项 目 
中 。 作为 谷歌 官方 旗下 产品 之 一 的 Android 系统 , 可 以 非常 方便 地 使 用 Google 地 图 实现 位 置 定 位 功能 。 
本 章 将 详细 讲解 在 Android 设备 中 使 用 位 置 服务 和 地 图 API 的 基本 流程 ， 为 读者 步 入 本 书后 面 知识 的 
学 习 打 下 基础 。 


9] 位 置 服务 


А 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 9 章 \ 位 置 服务 .avi 

在 Android 系统 中 ， 可 以 使 用 谷歌 地 图 获取 当前 的 位 置信 息 ，Android 系统 可 以 无 颖 地 支持 GPS 
和 谷歌 网 络 地 图 。 在 现实 应 用 中 ， 通 常 将 各 种 不 同 的 定位 技术 称 之 为 LBS〈 意 为 基于 位 置 的 服务 ， 是 
Location Based Service 的 缩写 )， 它 是 通过 电信 移动 运营 商 的 无 线 电 通信 网 络 (如 GSM 网 、CDMA W) 
或 外 部 定位 方式 (如 GPS) 获取 移动 终端 用 户 的 位 置信 息 〈 地 理 坐 标 或 大 地 坐标 )， 在 GIS (Geographic 
Information System， 地 理 信息 系统 ) 平台 的 支持 下 ， 为 用 户 提供 相应 服务 的 一 种 增值 业务 。 本 节 将 详 
细 讲 解 在 Android 物 联网 设备 中 实现 位 置 服务 的 基本 知识 。 


9.1.1 类 location 详解 


在 Android 设备 中 ， 可 以 使 用 类 android.location 来 实现 定位 功能 。 
(1) Google Map API 
Android 系统 提供 了 一 组 访问 Google MAP 的 API， 借 助 Google MAP 及 定位 API， 就 可 以 在 地 图 
上 显示 用 户 当 前 的 地 理 位 置 。 在 Android 中 定义 了 一 个 名 为 com.google.android.maps HE, 其 中 包含 了 
系列 用 于 在 Google Map 上 显示 、 控 制 和 层 登 信息 的 功能 类 ， 下 面 是 该 包 中 最 重要 的 几 个 类 。 
MapActivity: 用 于 显示 Google MAP 的 Activity 类 ， 它 需要 连接 底层 网 络 。 
MapView: 用 于 显示 地 图 的 View 组 件 ， 它 必须 和 MapActivity 配合 使 用 。 
MapController: 用 于 控制 地 图 的 移动 。 
Overlay: 是 一 个 可 显示 于 地 图 之 上 的 可 绘制 的 对 象 。 
GeoPoint: 是 一 个 包含 经 纬度 位 置 的 对 象 。 
(2) Android Location API 
在 Android 设备 中 ， 实 现 定位 功能 的 相关 类 如 下 所 示 。 
LocationManager: 提供 访问 定位 服务 的 功能 ， 也 提供 了 获取 最 佳 定位 提供 者 的 功能 。 另 外 ， 
临近 警报 功能 《前 面 所 说 的 那 种 功能 ) 也 可 以 借助 该 类 来 实现 。 
LocationProvider: 是 定位 提供 者 的 抽象 类 。 定 位 提供 者 具备 周期 性 报告 设备 地 理 位 置 的 功能 。 


ARAARA 
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LocationListener: 提供 定位 信息 发 生 改变 时 的 回调 功能 。 必 须 事先 在 定位 管理 器 中 注册 监听 
器 对 象 。 
Criteria: 使 得 应 用 能 够 通过 在 LocationProvider 中 设置 的 属性 来 选择 合适 的 定位 提供 者 。 


9.1.2 ”实现 定位 服务 功能 


在 Android 设备 中 ， 实 现 定位 处 理 的 基本 流程 如 下 所 示 。 
(1) 编写 Activity 类 
这 一 步 的 目的 是 使 用 Google Map АРІ 来 显示 地 图 ,然后 使 用 定位 API 来 获取 设备 的 当前 定位 信息 ， 
以 在 Google Мар 上 设置 设备 的 当前 位 置 ， 用 户 定位 会 随 着 用 户 的 位 置 移动 而 发 生 改 变 。 
首先 需要 一 个 继承 MapActivity 的 Activity 类 ， 例 如 下 面 的 代码 。 
class MyGPSActivity extends MapActivity { 


要 成 功 引用 Google MAP API， 还 必须 先 在 AndroidManifest.xml 中 定义 如 下 信息 。 
<uses-library android:name="com.google.android.maps"/> 
(2) 使 用 MapView 
要 先 在 设备 屏幕 中 显示 地 图 ， 需 要 将 MapView 加 入 到 应 用 中 来 。 例 如 在 布局 文件 (main.xml) 中 
加 入 如 下 所 示 的 代码 。 
<com.google.android.maps.MapView 
android:id="@+id/myGMap" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:enabled-"true" 
android:clickable-"true" 
android:apiKey-"API Key String" 
> 
另外 ， 要 使 用 Google Map 服务 ， 还 需要 一 个 АРІ key。 可 以 通过 如 下 方式 获取 API key: 
找到 USER_HOME\Local Settings\Application Data\Android 目录 下 的 debug.keystore 文件 。 
М ”使 用 keytool 工具 来 生成 认证 信息 (MD5)， 使 用 如 下 命令 行 : 
keytool -list -alias androiddebugkey -keystore «path to debug keystore».keystore -storepass 
android -keypass android 
М {Т Sign Up for the Android Maps АРІ 页 面 , 输入 之 前 生成 的 认证 信息 CMDS) 将 获取 到 用 户 
的 API key. 
蔡 换 上 面 AndroidManifest.xml 配置 文件 中 API Key String 为 刚才 获取 的 API key. 


注意 : 上 面 获取 API key 的 介绍 比较 简单 ， 后 面 将 会 通过 一 个 具体 实例 来 演示 获取 API key HFK, 


继续 补 全 MyGPSActivity 类 的 代码 ， 在 此 使 用 MapView， 例 如 下 面 的 代码 。 
class MyGPSActivity extends MapActivity { 
@Override 
public void onCreate(Bundle savedinstanceState) { 
/创建 并 初始 化 地 图 
gMapView = (MapView) findViewByld(R.id.myGMap); 
GeoPoint p = new GeoPoint((int) (lat * 1000000), (int) (long * 1000000)); 
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gMapView.setSatellite(true); 
mc = gMapView.getController(); 
mc.setCenter(p); 
mc.setZoom(14); 
} 
} 
另外 ,必须 先 设置 一 些 权 限 后 才能 使 用 定位 信息 , 在 文件 AndroidManifest.xml 中 的 配置 方式 如 下 : 
<uses-permission android:name="android.permission.INTERNET"></uses-permission> 
<uses-permission android:name="android.permission ACCESS _COARSE_LOCATION"></uses-permission> 
<uses-permission android:name="android.permission. ACCESS_FINE_LOCATION"></uses-permission> 
(3) 实现 定位 管理 器 
可 以 使 用 Context.getSystemService() 方 法 实现 定位 管理 器 功能 ， 并 传 入 Context.LOCATION_ 
SERVICE 参数 来 获取 定位 管理 器 的 实例 。 例 如 下 面 的 代码 。 
LocationManager Im = (LocationManager) getSystemService(Context.LOCATION SERVICE); 
将 原先 的 MyGPSActivity 作 一 些 修改 ， 让 它 实现 一 个 LocationListener 接口 ， 使 其 能 够 监听 定位 信 
息 的 改变 : 
class MyGPSActivity extends MapActivity implements LocationListener { 
public void onLocationChanged(Location location) {} 
public void onProviderDisabled(String provider) {} 
public void onProviderEnabled(String provider) {} 
public void onStatusChanged(String provider, int status, Bundle extras) {} 
protected boolean isRouteDisplayed() { 
return false; 
} 
} 
初始 化 LocationManager， 并 在 它 的 onCreate() 方 法 中 注册 定位 监听 器 。 例 如 下 面 的 代码 。 
@Override 
public void onCreate(Bundle savedinstanceState) { 
LocationManager Im = (LocationManager)getSystemService(Context.LOCATION_SERVICE); 
Im.requestLocationUpdates(LocationManager.GPS PROVIDER, 1000L, 500.0f, this); 
} 
这 样 代码 中 的 方法 onLocationChangedO 会 在 用 户 的 位 置 发 生 500 米 距离 的 改变 之 后 进行 调用 。 这 
里 默认 使 用 的 LocationProvider 是 “gps”(GSP_ PROVIDER)， 但 是 可 以 根据 需要 ， 使 用 特定 的 Criteria 
对 象 调用 LocationManger 类 的 getBestProvider0 方 法 获取 其 他 的 _ LocationProvider 。 以 下 代码 是 
onLocationcC hanged() 方 法 的 参考 实现 。 
public void onLocationChanged(Location location) { 
if (location != null) ( 
double lat = location.getLatitude(); 
double Ing = location.getLongitude(); 
p = new GeoPoint((int) lat * 1000000, (int) Ing * 1000000); 
mc.animateTo(p); 
} 
} 
通过 上 面 的 代码 ， 获 取 了 当前 的 新 位 置 并 在 地 图 上 更 新 位 置 显示 。 还 可 以 为 应 用 程序 添加 一 些 诸 
如 缩放 效果 、 地 图 标注 和 文本 等 功能 。 
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(4) 添加 缩放 控件 
/将 缩放 控件 添加 到 地 图 上 
ZoomControls zoomControls =  (ZoomControls) gMapView.getZoomControls(); 
zoomControls.setLayoutParams(new ViewGroup.LayoutParams(LayoutParams. WRAP CONTENT, 
LayoutParams. WRAP. CONTENT)); 
gMapView.addView(zoomControls); 
gMapView.displayZoomControls(true); 
(5) 添加 Map Overlay 
最 后 一 步 是 添加 Map Overlay， 例 如 通过 下 面 的 代码 可 以 定义 一 个 overlay。 
class MyLocationOverlay extends com.google.android.maps.Overlay { 
public boolean draw(Canvas canvas, MapView mapView, boolean shadow, long when) { 
super.draw(canvas, mapView, shadow); 
Paint paint = new Paint(); 
/将 经 纬度 转换 成 实际 屏幕 坐标 
Point myScreenCoords = new Point(); 
mapView.getProjection().toPixels(p, myScreenCoords); 
paint.setStrokeWidth(1); 
paint.setARGB(255, 255, 255, 255); 
paint.setStyle(Paint.Style. STROKE); 
Bitmap bmp = BitmapFactory.decodeResource(getResources(), R.drawable.marker); 
canvas.drawBitmap(bmp, myScreenCoords.x, myScreenCoords.y, paint); 
canvas.drawText("how are you...", myScreenCoords.x, myScreenCoords.y, paint); 
return true; 
} 
} 
通过 上 面 的 Overlay 会 在 地 图 上 显示 一 段 文本 ， 接 下 来 可 以 把 这 个 Overlay 添加 到 地 图 上 去 。 
MyLocationOverlay myLocationOverlay = new MyLocationOverlay(); 
List<Overlay> list = gMapView.getOverlays(); 
list.add(myLocationOverlay); 


9.1.3 ”实战 演练 一 一 在 Android 设备 中 实现 GPS 定位 


下 面 将 通过 具体 实例 来 演示 在 Android 设备 中 实现 GPS 定位 功能 的 基本 流程 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 在 文件 AndroidManifestxml 中 添加 ACCESS FINE LOCATION 权限， 具体 代码 如 下 : 
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> 
(2) 在 onCreate(Bundle savedInstanceState) 中 获取 当前 位 置信 息 ， 通 过 LocationManager 周期 性 获 
得 当前 设备 的 一 个 类 。 要 想 获取 LocationManager 实例 ， 必 须 调 用 Context.getSystemService() 方 法 并 传 
入 服务 名 LOCATION SERVICE("location"). 6] LocationManager 实例 后 可 以 通过 调用 getLastKnown 
Location0 方 法 将 上 一 次 LocationManager 获得 有 效 位 置信 息 以 Location 对 象 的 形式 返回 。 
getLastKnownLocation() 方 法 需要 传 入 一 个 字符 串 参 数 来 确定 使 用 定位 服务 类 型 ， 本 实例 传 入 的 是 静态 
常量 LocationManagerGPS_PROVIDER， 这 表示 使 用 GPS 技术 定位 。 最 后 还 需要 使 用 Location 对 象 将 
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位 置信 息 以 文本 方式 显示 到 用 户 界面 。 具 体 实现 代码 如 下 : 
public void onCreate(Bundle savedinstanceState) { 

super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
LocationManager locationManager; 
String serviceName = Context.LOCATION_SERVICE; 
locationManager = (LocationManager)getSystemService(serviceName); 
Criteria criteria = new Criteria(); 
criteria.setAccuracy(Criteria. ACCURACY FINE); 
criteria.setAltitudeRequired(false); 
criteria.setBearingRequired(false); 
criteria.setCostAllowed(true); 
criteria.setPowerRequirement(CriteriasPOWER LOW); 
String provider 7 locationManager.getBestProvider(criteria, true); 


Location location = locationManager.getLastKnownLocation(provider); 

updateWithNewLocation(location); 

/每 隔 1000ms 更 新 一 次 */ 

locationManager.requestLocationUpdates(provider, 2000, 10, 
locationListener); 


} 


第 9 章 ”GPS 地 图 定位 


(3) 定义 方法 updateWithNewLocation(Location location) 更 新 显示 用 户 界 面 ， 具 体 代码 如 下 : 


private void updateWithNewLocation(Location location) { 

String latLongString; 

TextView myLocationText; 

myLocationText = (TextView)findViewByld(R.id.myLocationText); 
if (location != null) { 

double lat = location.getLatitude(); 

double Ing = location.getLongitude(); 

latLongString = "纬度 是 :" + lat + "n 经 度 是 :" + Ing; 

}else { 

latLongString = "失败 "; 


i + 
latLongString); 
} 

} 


(4) Ж X. LocationListener 对 象 locationListener， 当 坐标 改变 时 触发 此 函数 。 如 果 Provider 传 进 相 


同 的 坐标 ， 它 就 不 会 被 触发 。 具 体 代码 如 下 : 
private final LocationListener locationListener = new LocationListener() { 
public void onLocationChanged(Location location) { 
updateWithNewLocation(location); 
} 
public void onProviderDisabled(String provider){ 
updateWithNewLocation(null); 
} 
public void onProviderEnabled(String provider){ } 
public void onStatusChanged(String provider, int status, 
Bundle extras){ } 


y 
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下 面 开始 测试 , 因为 模拟 器 上 没有 GPS 设备 ,所 以 需要 在 Eclipse 的 DDMS 工具 中 提供 模拟 的 GPS 
数据 。 即 依次 选择 DDMS | Emulator Control 命令 ， 在 弹出 的 对 话 框 中 找到 Location Control 选项 ， 在 
此 输入 坐标 ， 完 成 后 单 击 Send 按钮 ， 如 图 9-1 所 示 。 

Wesa |o |m | 
© Decimal. 
C Sexagesimal 


Longi tude [-122. 064095 


Latitude [57.422006 


[Ss] 


图 9-1 设置 坐标 


因为 用 到 了 Google API， 所 以 要 在 项 目 中 引入 Google API， 右 击 项 目 ， 在 弹出 的 快捷 菜单 中 选择 
Properties 命令 ， 在 弹出 的 对 话 框 中 选择 Google APIs 版 本 ， 如 图 9-2 所 示 。 


[Project muid Target 
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图 9-2 引用 Google APIs 


这 样 模拟 器 运行 后 会 显示 当前 的 坐标 ， 如 图 9-3 所 示 。 


Cürrenttocation. 


图 9-3 执行 效果 


92 随时 更 新 位 置信 息 


EM 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 9 章 \ 随 时 更 新 位 置信 息 .avi 
随 着 物 联网 设备 的 移动 ，GPS 的 位 置信 息 也 会 发 生变 化 ， 此 时 可 以 通过 编程 的 方式 来 及 时 获取 并 
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更 新 当前 的 位 置信 息 。 本 节 将 详细 讲解 随时 更 新 位 置信 息 的 基本 知识 。 


9.2.1 Ё Maps 中 的 类 


ТЕ) Maps 中 提供 了 十 几 个 类 , 通过 这 些 类 可 以 实现 位 置 更 新 功能 。 在 这 些 库 类 中 ,最 为 常用 的 类 
包括 MapController、MapView 和 MapActivity 等 。 
(1) MapController 
控制 地 图 移动 、 伸 缩 ， 以 某 个 GPS 坐标 为 中 心 ， 控 制 MapView 中 的 View 组 件 ， 管 理 Overlay, 
提供 View 的 基本 功能 。 使 用 多 种 地 图 模式 如 地 图 模式 〈 某 些 城市 可 实时 对 交通 状况 进行 更 新 )、 卫 星 
模式 、 街 景 模 式 ) 来 查看 Google Map。 常 用 方法 有 animateTo(GeoPoint point). setCenter(GeoPoint point) 
和 setZoom(int zoomLevel)^$ . 
(2) MapView 
MapView 是 用 来 显示 地 图 的 view， 它 派生 自 android.view.ViewGroup. “4 MapView 获得 焦点 时 ， 
可 以 控制 地 图 的 移动 和 缩放 。Android 中 的 地 图 可 以 以 不 同 的 形式 显示 出 来 , 如 街景 模式 、 卫星 模式 等 。 
MapView 只 能 被 MapActivity 来 创建 ， 这 是 因为 MapView 需要 通过 后 台 的 线程 来 连接 网 络 或 者 文 
件 系统 ， 而 这 些 线程 要 由 MapActivity 来 管理 。 常 用 方法 有 getController(). getOverlays() ~ 
setSatellite(boolean)、setTraffic(boolean)、setStreetView(boolean) 和 setBuiltInZoomControls(boolean) 等 。 
(3) MapActivity 
MapActivity 是 一 个 抽象 类 ， 任 何 想 要 显示 MapView 的 Activity 都 需要 派生 自 MapActivity。 并 且 
在 其 派生 类 的 onCreate0 中 ， 都 要 创建 一 个 MapView 实例 ， 可 以 通过 MapViewconstructor (然后 添加 到 
View 中 ViewGroup.addView(View)) 或 者 layout XML 来 创建 。 
(4) Overlay 

Overlay 是 覆盖 到 MapView 的 最 上 层 ， 可 以 扩展 其 ondraw 接口 ， 自 定义 在 MapView 中 显示 一 些 

自己 的 东西 。MapView 通过 MapView.getOverlaysQXJ Overlay 进行 管理 。 

除了 Overlay ix SSE, Google 还 扩展 了 如 下 两 个 比较 有 用 的 Overlay. 

М MylocationOverlay: 集成 了 Android.location 中 接收 当前 坐标 的 接口 ， 集 成 SersorManager 中 
CompassSensor 的 接口 。 只 需要 enableMyLocation(), enableCompass 即 可 让 程序 拥有 实时 的 
MyLocation 以 及 Compass 功能 (Activity.onResume()''). 

ItemlizedOverlay: 管理 一 个 Overlayltem 链表 ， 用 图 片 等 资源 在 地 图 上 作风 格 相同 的 标记 。 

(5) Projection 
MapView 中 GPS 坐标 与 设备 坐标 的 转换 (GeoPoint 和 Point). 
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LocationManager 支持 监听 器 模式 ， 通 过 调用 requestLocationUpdates0) 方 法 能 够 为 其 设置 一 个 位 置 
监听 器 LocationListener。 同 时 方法 requestLocationUpdates() 还 需要 指定 要 使 用 的 位 置 服务 类 型 、 位 置 更 
新 时 间 和 最 新 位 移 ， 这 样 可 以 确保 在 满足 用 户 需求 的 前 提 下 最 低 的 电量 消耗 。 

例如 在 下 面 的 代码 中 ， 设 置 了 更 新 位 置信 息 的 最 小 间隔 为 2 秒 , 位 移 变 化 在 10 米 以 上 。 如 果 GPS 
位 置 超过 10 Ж, 且 时 间 间 隔 超过 2 秒 时 , LocationListener 的 回调 方法 onLocationChanged0 就 会 被 调用 ， 


HE: 


Android 物 联 网 开发 从 入 门 到 实战 


应 用 程序 可 以 通过 onLocationChanged 来 反映 位 置信 息 的 变化 。 
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public class CurrentLocationWithMap extends MapActivity { 


public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlInstanceState); 
setContentView(R.layout.main); 
LocationManager locationManager; 
String context = Context. LOCATION, SERVICE; 
locationManager = (LocationManager)getSystemService(context); 
//String provider = LocationManager.GPS PROVIDER; 
/*Location Provider 查询 条 件 */ 
Criteria criteria = new Criteria(); 
criteria.setAccuracy(Criteria.ACCURACY FINE); 
criteria.setAltitudeRequired(false); 
criteria.setBearingRequired(false); 
criteria.setCostAllowed(true); 
criteria.setPowerRequirement(Criteria.POWER LOW); 
String provider 7 locationManager.getBestProvider(criteria, true); 


Location location = locationManager.getLastKnownLocation(provider); 


updateWithNewLocation(location); 

/设置 更 新 位 置信 息 的 最 小 间隔 为 2 秒 ， 位 移 变化 在 10 OREL E" 

locationManager.requestLocationUpdates(provider, 2000, 10, 
locationListener); 


} 
Location 发 生变 化 时 被 调用 */ 
private final LocationListener locationListener = new LocationListener() { 


public void onLocationChanged(Location location) { 
updateWithNewLocation(location); 
} 
public void onProviderDisabled(String provider){ 
updateWithNewLocation(null); 
} 
public void onProviderEnabled(String provider){ } 
public void onStatusChanged(String provider, int status, 
Bundle extras){ } 
y 
private void updateWithNewLocation(Location location) { 
String latLongString; 
TextView myLocationText; 
myLocationText = (TextView)findViewByld(R.id.myLocationText); 
if (location != null) { 
double lat = location.getLatitude(); 
double Ing = location.getLongitude(); 
latLongString = "纬度 是 :" + lat + "n 经 度 是 :" + Ing; 
ctriMap.animateTo(new GeoPoint((int)(lat*1E6),(int)(Ing*1E6))); 
) else { 
latLongString = "失败 "; 
} 
myLocationText.setText(" 获 取 的 当前 位 置 是 :\n" +latLongString); 
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在 使 用 类 LocationManager 时 ， 通 常 需要 用 到 如 下 所 示 的 方法 。 
М getLatitude0: 获取 经 度 值 。 

getLongitude(): 获取 纬度 值 。 

getAltitude(): 获取 海拔 值 。 


9.2.3 ”实战 演练 一 监听 当前 设备 的 坐标 和 海拔 


本 节 将 通过 具体 实例 来 演示 在 Android 设备 中 显示 当前 位 置 的 坐标 和 海拔 的 基本 方法 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 在 文件 AndroidManifestxml 中 添加 ACCESS FINE LOCATION 权限 和 ACCESS LOCATION - 


EXTRA COMMANDS 权限 ， 有 具体 代码 如 下 : 
<uses-permission android:name-"android.permission.ACCESS FINE LOCATION" /> 
<uses-permission android:name-"android.permission.ACCESS LOCATION EXTRA COMMANDS"/- 
(2) 编写 布局 文件 main.xml， 设 置 在 屏幕 中 分 别 显示 当前 位 置 的 经 度 、 纬 度 、 速 度 和 海拔 等 信息 。 
文件 main.xml 的 具体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent" 
android:layout_height="fill_ parent" 
android:background="#008080" 
android:id="@+id/mainlayout" android:orientation="vertical"> 


«gps.mygps.paintview android:id="@+id/iddraw" 
android:layout_width="fill_parent" 
android:layout_height="300dip" 

> 


<TableLayout android:layout_width="fill_parent" 
android:layout_height="wrap_content"> 


<TableRow> 

<TextView android:id="@+id/speed" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 速 度 " 
style="@style/smalltext" 
android:gravity="center" 
android:layout_weight="33"/> 

<TextView android:id="@+id/altitude" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 海 拔 " 
style="@style/smalltext" 
android:gravity-"center" 
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«TextView 


</TableRow> 
<TableRow> 


<TextView 


<TextView 


<TextView 


</TableRow> 
</TableLayout> 


android:layout_weight="33"/> 
android:id="@+id/bearing" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 航 向 ” 
style="@style/smalltext" 
android:gravity="center" 
android:layout_weight="34"/> 


android:id="@+id/speedvalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:gravity-"center" 
android:layout_weight="33"/> 

android:id="@+id/altitudevalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:layout_weight="33" 
android:gravity="center"/> 

android:id="@+id/bearvalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:gravity="center" 
android:layout_weight="34"/> 


<TableLayout android:layout_width="fill_parent" 
android:layout_height="wrap_content"> 


<TableRow> 


<TextView 


<TextView 


<TextView 


的 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="#E &" 
android:gravity-"center" 
android:layout_weight="50" 
style="@style/smalltext"/> 

android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" D е" 
android:gravity="center" 
android:layout_weight="50" 
style="@style/smalltext"/> 

android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"£z RE" 
style-"Qstyle/smalltext" 
android:gravity-"center" 
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android:layout_weight="50"/> 
</TableRow> 
<TableRow> 

<TextView android:id="@+id/latitudevalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:gravity="center" 
android:layout_weight="33"/> 

<TextView android:id="@+id/satellitevalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:gravity-"center" 
android:layout_weight="33"/> 

<TextView android:id="@+id/longitudevalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
android:gravity-"center" 
android:layout_weight="34"/> 


</TableRow> 
</TableLayout> 
<TableLayout android:layout_width="fill_parent" 
android:layout_height="wrap_content"> 
<TableRow> 
<TextView android:id="@+id/time" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 时 间 :" 
style="@style/normaltext" 
> 


<TextView android:id="@-+id/timevalue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
style="@style/normaltext" 
> 
</TableRow> 
</TableLayout> 


<RelativeLayout android:layout_width="fill_parent" 
android:layout_height="wrap_content"> 
«Button android:id="@+id/close" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" X i)" 
android:textSize="20sp" 
android:layout_alignParentRight="true"></Button> 
«Button android:id="@+id/open" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 


341 


Android 物 联 网 开发 从 入 门 到 实战 


android:text="T FF" 
android:textSize="20sp" 
android:layout_toLeftOf="@id/close"></Button> 
</RelativeLayout> 


<TextView android:id="@+id/error" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
style="@style/smalltext" 
> 
</LinearLayout> 


(3) 编写 程序 文件 Муррѕ јауа, 功能 是 监听 用 户 单 击 屏幕 按钮 的 事件 ,获取 当前 位 置 的 定位 信息 。 
文件 Mygps.java 的 具体 实现 代码 如 下 : 
public class Mygps extends Activity { 


protected static final String TAG = null; 
/位 置 类 

private Location location; 

/定位 管理 类 

private LocationManager locationManager; 
private String provider; 

// 监 听 卫 星 变 量 

private GpsStatus gpsStatus; 
lterable<GpsSatellite> allSatellites; 

float satellitedegree[][] = new float[24][3]; 


float alimuth[] = new  float[24]; 
float elevation[] = new float[24]; 
float snr[] = new float[24]; 


private boolean status=false; 
protected Iterator<GpsSatellite> Iteratorsate; 
private float bear; 


// 获 取 手 机 屏幕 分 辩 率 的 类 
private DisplayMetrics ат; 


paintview layout; 
Button openbutton; 
Button closebutton; 
TextView latitudeview; 
TextView longitudeview; 
TextView altitudeview; 
TextView speedview; 
TextView timeview; 
TextView errorview; 
TextView bearingview; 
TextView satcountview; 
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@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
requestWindowFeature(Window.FEATURE NO TITLE); 
getWindow().setFlags(WindowManager.LayoutParams.FLAG FULLSCREEN, 
WindowManager.LayoutParams.FLAG_FULLSCREEN); 
setContentView(R.layout.main); 


findview(); 


openbutton.setOnClickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
if(Istatus) 
openGPSSettings(); 
getLocation(); 
status - true; 
) 
} 
» 
closebutton.setOnClickListener(new View.OnClickListener() ( 
@Override 
public void onClick(View v) { 
closeGps(); 
} 
» 
} 


private void findview() { 

openbutton = (Button)findViewByld(R.id.open); 

closebutton = (Button)findViewByld(R.id.close); 
latitudeview = (TextView)findViewByld(R.id.latitudevalue); 
longitudeview = (TextView)findViewByld(R.id.longitudevalue); 
altitudeview = (TextView)findViewByld(R.id.altitudevalue); 
speedview = (TextView)findViewByld(R.id.speedvalue); 
timeview = (TextView)findViewByld(R.id.timevalue); 
errorview = (TextView)findViewByld(R.id.error); 
bearingview = (TextView)findViewByld(R.id.bearvalue); 
layout-(gps.mygps.paintview)findViewByld(R.id.iddraw); 
satcountview = (TextView)findViewByld(R.id.satellitevalue); 
} 


protected void closeGps() { 
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ll dm = new DisplayMetrics(); 

II getWindowManager().getDefaultDisplay().getMetrics(dm); 
II heightp = dm.heightPixels; 

11 widthp = dm.widthPixels; 

II alimuth[0] = 60; 

II elevation[0] = 20; 

II snr[0] = 60; 

II alimuth[1] = 260; 

II elevation[1] = 10; 

II snr[1] = 50; 

lI layout.redraw(240,alimuth,elevation,snr, widthp,heightp, 2); 


if(status == true) 
{ 
locationManager.removeUpdates(locationListener); 
locationManager.removeGpsStatusListener(statusListener); 
errorview.setText(""); 
latitudeview.setText(""); 
longitudeview.setText(""); 
speedview.setText(""); 
timeview.setText(""); 
altitudeview.setText(""); 
bearingview.setText(""); 
satcountview.setText(""); 
status - false; 


/定位 监听 类 负责 监听 位 置信 息 的 变化 情况 
private final LocationListener locationListener = new LocationListener() 


{ 


@Override 
public void onLocationChanged(Location location) 


{ 
/获取 GPS 信息 和 位 置 提供 者 provider 中 的 位 置信 息 
II location = locationManager.getLastKnownLocation(provider); 
// 通 过 GPS 获取 位 置 
updateToNewLocation(location); 
IIshowinfo(getLastPosition(), 2); 


} 


@Override 
public void onProviderDisabled(String argO) 
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@Override 
public void onProviderEnabled(String arg0) 


{ 
} 


@Override 
public void onStatusChanged(String arg0, int arg1, Bundle arg2) 


{ 


updateToNewLocation(null); 


} 


/添加 监听 卫星 
private final GpsStatus.Listener statusListener= new GpsStatus.Listener(){ 


@Override 
public void onGpsStatusChanged(int event) { 
/TODO Auto-generated method stub 
/获取 GPS 卫星 信息 
gpsStatus = locationManager.getGpsStatus(null); 


Switch(event) 
{ 
case GpsStatus.GPS_EVENT_STARTED: 


break; 
/第 一 次 定位 时 间 
case GpsStatus.GPS_EVENT_FIRST_FIX: 


һгеак; 
// 收 到 的 卫星 信息 

case GpsStatus.GPS_EVENT_SATELLITE_STATUS: 
DrawMap(); 


break; 


case GpsStatus.GPS_EVENT_STOPPED: 
break; 
} 
} 
Е 
private int heightp; 
private int widthp; 


private void openGPSSettings() 
{ 


ll dm = new DisplayMetrics(); 
lI getWindowManager().getDefaultDisplay().getMetrics(dm); 


mm 
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II heightp = dm.heightPixels; 

11 widthp = dm.widthPixels; 

11 alimuth[0] = 60; 

II elevation[0] = 70; 

II snr[0] = 60; 

II alimuth[1] = 260; 

II elevation[1] = 10; 

II snr[1] = 50; 

lI layout.redraw(50,alimuth,elevation,snr, widthp,heightp, 2); 


// 获 取 位 置 管理 服务 
locationManager = (LocationManager)this.getSystemService(Context.LOCATION_SERVICE); 
if (locationManager.isProviderEnabled(android.location.LocationManager.GPS PROVIDER)) 
{ 

Toast.makeText(this, "GPS 模块 正常 ", Toast.LENGTH_SHORT).show(); 

return; 


status = false; 

Toast.makeText(this, "请 开启 GPS! ", Toast.LENGTH_SHORT).show(); 
Intent intent = new Intent(Settings ACTION_SECURITY_SETTINGS); 
startActivityForResult(intent,0); // 此 为 设置 完成 后 返回 的 获取 界面 } 


} 


protected void DrawMap() { 
IITODO Auto-generated method stub 


int i = 0; 

// 获 取 屏 幕 信息 

dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(dm); 
heightp = dm.heightPixels; 

widthp = dm.widthPixels; 


// 获 取 卫 星 信 息 
allSatellites = gpsStatus.getSatellites(); 
Iteratorsate = allSatellites.iterator(); 


while(Iteratorsate.hasNext()) 


{ 
GpsSatellite satellite = Iteratorsate.next(); 
alimuth[i] = satellite.getAzimuth(); 
elevation[i] = satellite.getElevation(); 
snr[i] = satellite.getSnr(); 
i++; 

} 


satcountview.setText(""+i); 
layout.redraw(bear,alimuth,elevation,snr, widthp,heightp, i); 
layout.invalidate(); 


} 
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private void getLocation() 


{ 


/查找 到 服务 信息 ， 位 置 数据 标准 类 

Criteria criteria = new Criteria(); 

// 查 询 精度 :高 
criteria.setAccuracy(Criteria.ACCURACY FINE); 
/是 否 查询 海拔 :是 
criteria.setAltitudeRequired(true); 

/是 否 查询 方位 角 : 是 
criteria.setBearingRequired(true); 

// 是 否 允许 付费 

criteria.setCostAllowed(true); 

// 电 量 要 求 : 底 
criteria.setPowerRequirement(Criteria.POWER_LOW); 
// 是 否 查 询 速 度 :是 
criteria.setSpeedRequired(true); 


provider = locationManager.getBestProvider(criteria, true); 


// 获 取 GPS 信息 ， 获 取 位 置 提供 者 provider 中 的 位 置信 息 

location = locationManager.getLastKnownLocation(provider); 

/通过 GPS 获取 位 置 

updateToNewLocation(location); 

// 设 置 监听 器 ， 自 动 更 新 的 最 小 时 间 为 间隔 № (1 秒 为 1*1000， 这 样 写 主要 为 了 方便 ) 或 最 小 位 移 变化 超 
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/实时 获取 位 置 提供 者 provider 中 的 数据 ， 一 旦 发 生 位 置 变化 ， 立 即 通知 应 用 程序 
locationManager.requestLocationUpdates(provider, 1000, 0,locationListener); 
/监听 卫星 

locationManager.addGpsStatusListener(statusListener); 


} 


private void updateToNewLocation(Location location) 


{ 


if (location != null) 


{ 


bear = location.getBearing(); 


double latitude = location.getLatitude(); /| 纬度 
double longitude= location.getLongitude(); /| 经 度 
float GpsSpeed = location.getSpeed(); // 速 度 
long GpsTime = location.getTime(); /时 间 


Date date = new Date(GpsTime); 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
double GpsAlt = location. getAltitude(); /海拔 


latitudeview.setText("" + latitude); 
longitudeview.setText("" + longitude); 
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speedview.setText(""+GpsSpeed); 
timeview.setText(""+df.format(date)); 
altitudeview.setText(""+GpsAlt); 
bearingview.setText(""+bear); 


} 


else 

{ 
errorview.setText( "无 法 获取 地 理 信息 "); 
} 

} 


} 
本 实例 在 模拟 器 中 的 执行 效果 如 图 9-4 所 示 。 


пя [ха 


图 9-4 在 模拟 器 中 的 执行 效果 
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CAO 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 9 章 \ 在 设备 中 使 用 地 图 .avi 
在 Android 设备 中 可 以 直接 使 用 Google 地 图 ， 可 以 用 地 图 的 形式 显示 位 置信 息 。 下 面 将 详细 讲解 
在 Android 设备 中 使 用 Google 地 图 的 方法 。 


9.3.1 添加 Google Map 244A 


Android 系统 中 提供 了 一 个 map © (com.google.android.maps), iid Kf] MapView 可 以 方便 地 
利用 Google 地 图 资源 来 进行 编程 ， 可 以 在 Android 设备 中 调用 Google 地 图 。 在 使 用 Google 地 图 之 前 
需要 进行 如 下 所 示 的 配置 工作 。 

(1) 添加 maps.jar 

在 Android SDK 中 , 以 JAR 库 的 形式 提供 了 和 Google Map 有 关 的 АРІ, 此 JAR 库 位 于 android-sdk- 
windows\add-ons\google apis-4 目录 下 。 要 把 maps.jar 添加 到 项 目 中 ， 可 以 在 项 目 属性 的 Android 栏 中 
指定 使 用 包含 Google API 的 Target 作为 项 目的 构建 目标 ， 如 图 9-5 所 示 。 

(2) 将 地 图 嵌入 到 应 用 

通过 使 用 MapActivity 和 MapView 控件 ， 可 以 轻松 地 将 地 图 嵌入 到 应 用 程序 中 。 在 此 步 又 中 ， 需 
要 将 Google API 添 加 到 构建 路 径 中 .方法 是 在 图 9-6 所 示 界 面 中 选择 Java Build Path 节点 ,然后 在 Target 
中 选中 Google APIs 复 选 框 ， 设 置 项 目 中 包含 Google API. 
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图 9-6 将 Google API 添加 到 构建 路 径 


(3) 获取 Map API 密 钥 
在 利用 MapView 之 前 ， 必 须要 先 申 请 一 个 Android Map API Key。 具 体 步骤 如 下 。 
第 1 步 : 找到 debug.keystore 文件 ， 通 常 位 于 如 下 目录 中 。 
C:\Documents and Settings\ 你 的 当前 用 户 \Local Settings\Application Data\Android 
第 2 步 : 获取 MDS 指纹 。 运 行 cmd.exe， 执 行 如 下 命令 获取 MDS 指纹 。 
>keytool -list -alias androiddebugkey -keystore "debug.keystore 的 路 径 " -storepass android -keypass android 
例如 笔者 机 器 输入 如 下 命令 : 


此 时 系统 会 提示 输入 keystore 密码 ， 这 时 输入 “android”， 系 统 就 会 输出 我 们 申请 到 的 MDS 认证 


指纹 ， 如 图 9-7 所 示 。 
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图 9-7 获取 的 认证 指纹 


注意 : 因为 在 CMD 中 不 能 直接 复制 、 粘 贴 ， 这 样 很 影响 我 们 的 编程 效率 ， 所 以 笔者 使 用 了 第 三 方 软 
件 PowerCmd 来 代替 机 器 中 自 带 的 CMD 工具 。 


第 3 步 : 申请 Android map 的 API Key。 
打开 浏览 器 ， 输 入 网 址 http://code.google.com/intl/zh-CN/android/maps-api-sienup.html, ПР 9-8 所 示 。 
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图 9-8 ”申请 主页 
在 Google 的 android map API Key 申请 页 面 上 输入 图 9-8 中 得 到 的 MD5 认证 指纹 , 单 击 Generate API 
Key 按钮 后 即 可 转 到 如 图 9-9 所 示 的 画面 ， 得 到 我 们 申请 到 的 APIKey。 


Google Google 地 图 API 


Googe (SB S» Google 地 图 API > Google 地 图 AP 注册 


感谢 您 注册 Android 地 图 АР! #71! 
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图 9-9 得 到 的 API Key 


жов озшш — 


至 此 ， 就 成 功 地 获取 了 一 个 APIKey。 
9.3.2 ”使 用 Map API 密 钥 


当 申 请 到 一 个 Android Map API Key 后 ， 接 下 来 可 以 使 用 Map API 密 钥 实现 编程 ， 具 体 实 现 流程 
如 下 。 
(1) 在 AndroidManifestxml 中 声明 权限 
在 Android 系统 中 ， 如 果 程 序 执行 需要 读 取 到 安全 敏感 的 项 目 ， 那 么 必须 在 AndroidManifest.xml 
中 声明 相关 权限 请 求 ， 例 如 这 个 地 图 程序 需要 从 网 络 读 取 相 关 数 据 。 所 以 必须 声明 android.permission. 
INTERNET 权限 。 具 体 方法 是 在 文件 AndroidManifest.xml 中 添加 如 下 代码 。 
<uses-permission android:name="android.permission.INTERNET" /> 
另外 ， 因 为 maps 类 不 是 Android 启动 的 默认 类 ， 所 以 还 需要 在 文件 AndroidManifest.xml 的 
application 标签 中 声明 要 用 maps Ж: 
<uses-library android:name="com.google.android.maps" /> 
下 面 是 基本 的 AndroidManifest.xml 文件 代码 : 
«manifest xmIns:android-"http://schemas.android.com/apk/res/android" 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 
<uses-library android:name="com.google.android.maps" /> 
</application> 
<uses-permission android:name="android.permission.INTERNET" /> 
</manifest> 


(2) 在 布局 文件 main.xml 中 规划 UI 界面 
假设 要 显示 杭州 的 卫星 地 图 ， 并 在 地 图 上 方 有 5 个 按钮 ， 分 别 可 以 放大 地 图 、 缩 小 地 图 或 者 切换 
显示 模式 (卫星 、 交 通 和 街景 )。 即 整个 界面 主要 由 两 部 分 组 成 , 上 面 是 一 排 5 个 按钮 , 下 面 是 Map View. 
Android 中 的 LinearLayout FJ VAG ARK, 在 此 可 以 把 上 面 5 个 按钮 放 在 一 个 子 LinearLayout 里 边 
Cf. LinearLayout 的 指定 可 以 由 android:addStatesFromChildren="true" 实 现 )， 然 后 再 把 这 个 子 
LinearLayout 加 到 外 面 的 父 LinearLayout 中 。 具 体 实现 代码 如 下 : 
"为 了 简化 篇 幅 ， 去 掉 一 些 不 是 重点 说 明 的 属性 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" android:layout width-"fill parent" 
android:layout height-"fill parent" 


<LinearLayout android:layout widthz"fill parent" 


android:addStatesFromChildren="true" 让 说 明 是 子 Layout 
android:gravity-"center vertical" 让 这 个 子 Layout 中 的 按钮 是 横向 排列 
> 


<Button android:id="@+id/ZoomOut" 
android:text=" 放 大 " 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout marginTop-"5dip" I"REÉS 4 个 属性 ， 指 定 了 按钮 的 相对 位 置 
android:layout marginLeft-"30dip" 
android:layout marginRight-"5dip" 
android:layout marginBottom-"5dip" 
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android:padding="5dip" /> 


/其 余 4 个 按钮 省 略 
</LinearLayout> 
<com.google.android.maps.MapView 

android:id="@+id/map" 

android:layout_width="fill_parent" 

android:layout_height="fill_parent" 

android:enabled="true" 

android:clickable-"true" 

android:apiKey=" 在 此 输入 9.3.1 节 申 请 的 API KEY" /必须 加 上 9.3.1 节 申 请 的 API KEY 
> 


</LinearLayout> 
(3) 设置 主 文件 的 这 个 类 必须 继承 于 MapActivity 
public class Mapapp extends MapActivity { 
onCreate() 函 数 的 核心 代码 如 下 : 
public void onCreate(Bundle icicle) { 
// 取 得 地 图 View 
myMapView = (MapView) findViewByld(R.id.map); 
// 设 置 为 卫星 模式 
myMapView.setSatellite(true); 
// 地 图 初始 化 的 点 :杭州 
GeoPoint p = new GeoPoint((int) (30.27 * 1000000), 
(int) (120.16 * 1000000)); 
// 取 得 地 图 View 的 控制 
MapController mc = myMapView.getController(); 
// 定 位 到 杭州 
mc.animateTo(p); 
// 设 置 初始 化 倍数 
mc.setZoom(DEFAULT ZOOM LEVEL); 
} 
然后 编写 缩放 按钮 的 处 理 代 码 ， 具 体 如 下 : 
btnZoomln.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 
myMapView.getController().setZoom(myMapView.getZoomLevel() - 1); 
р; 
地 图 模式 的 切换 由 下 面 的 代码 实现 : 
btnSatellite.setOnClickListener(new View.OnClickListener() { 
public void onClick(View view) { 


myMapView.setSatellite(true); /卫星 模式 为 True 
myMapView.setTraffic(false); /交通 模式 为 False 
myMapView.setStreetView(false); /街景 模式 为 False 
} 
D 


至 此 ， 就 完成 了 第 一 个 使 用 Map API 的 应 用 程序 。 
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933 ”实战 演练 一 一 在 Android 设备 中 使 用 谷歌 地 图 实现 定位 


а НҢ | H 的 | 源码 路 径 
-实例 9-3 — | fE Android 设备 中 使 用 谷歌 地 图 实现 定位 Hétit:\daima\9\LocationMapEX — : 
其 具体 实现 流程 如 下 所 示 。 
(1) 在 布局 文件 main.xml 中 插入 两 个 Button， 分 别 实现 对 地 图 的 “放大 ”和 “缩小 ”然后 通过 
ToggleButton 控制 是 否 显示 卫星 地 图 ， 最 后 设置 申请 的 API Key。 具 体 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout height-"fill parent" 
> 
<TextView 
android:id="@+id/myLocationText" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
> 
<LinearLayout 
android:orientation-"horizontal" 
android:layout width-"fill parent" 
android:layout height-"wrap content" > 
«Button 
android:id="@+id/in" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:layout_weight="1" 
android:text-" jj A H5 Bg" /> 
«Button 
android:id="@+id/out" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:layout_weight="1" 
android:text=" 缩 小 地 图 " /> 
</LinearLayout> 
<ToggleButton 
android:id="@+id/switchMap" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textOff-" E JF" 
android:textOn=" 卫 星 开关 "/> 
<com.google.android.maps.MapView 
android:id="@+id/myMapView" 
android:layout_width="fill_ parent" 
android:layout height-"fill parent" 
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android:clickable="true" 
android:apiKey-"Oby7ffx8jX0A LWXeKCMTWAR8CqHAlqvzetFqjQ" 
I 
</LinearLayout> 
(2) 在 文件 AndroidManifest.xml 中 分 别 声明 android.permission INTERNET #1 INTERNET 权限 。 
具体 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
«manifest xmIns:android-"http://schemas.android.com/apk/res/android" 
package-"com.UserCurrentLocationMap" 
android:versionCode="1" 
android:versionName="1.0.0"> 
«application android:icon="@drawable/icon" android:label="@string/app_name"> 
«activity android:name=".UserCurrentLocationMap" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<uses-library android:name="com.google.android.maps"/> 
</application> 
<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission. ACCESS FINE LOCATION"/» 
</manifest> 
(3) 编写 主 程序 文件 CurrentLocationWithMap.java， 具 体 实现 流程 如 下 所 示 。 
通过 方法 onCreate0 将 MapView 绘制 到 屏幕 上 。 因 为 MapView 只 能 继承 自 MapActivity 中 的 
活动 ， 所 以 必须 用 方法 onCreate0 将 MapView 绘制 到 屏幕 上 ， 并 同时 覆盖 方法 isRoute 
Dispblayed0， 它 表示 是 否 需 要 在 地 图 上 绘制 导航 线路 。 主 要 代码 如 下 


package com.UserCurrentLocationMap; 


public class CurrentLocationWithMap extends MapActivity { 
MapView map; 


MapController ctriMap; 
Button inBtn; 
Button outBtn; 
ToggleButton switchMap; 
@Override 
protected boolean isRouteDisplayed() { 
return false; 
} 
加 ”定义 方法 опСтеаіе(), 首先 引入 主 布局 main.xml， 并 通过 方法 findViewById( 3k f$: MapView 对 
象 的 引用 ,接着 调用 getOverlays() 方 法 获取 其 Overylay 链表 , 并 将 构建 好 的 MyLocationOverlay 
对 象 添加 到 链表 中 去 。 其 中 MyLocationOverlay 对 象 调用 的 enableMyLocation() 方 法 表示 尝试 
通过 位 置 服务 来 获取 当前 的 位 置 。 具 体 代 码 如 下 : 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
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setContentView(R.layout.main); 


map = (MapView)findViewByld(R.id.myMapView); 

List<Overlay> overlays = map.getOverlays(); 

MyLocationOverlay myLocation = new MyLocationOverlay(this,map); 
myLocation.enableMyLocation(); 

overlays.add(myLocation); 

为 “放大 ”和 “缩小 ”这 两 个 按钮 设置 处 理 程序 ， 首 先 通过 方法 getController) 3k Ht MapView 
的 MapController 对 象 ， 然 后 在 “放大 ”和 “缩小 ”两 个 按钮 单 击 事件 监听 器 的 回放 方法 中 ， 
根据 按钮 的 不 同 实现 对 MapView 的 缩放 。 具 体 代码 如 下 : 

ctriMap = map.getController(); 

inBtn = (Button)findViewByld(R.id.in); 

outBtn = (Button)findViewByld(R.id.out); 

OnClickListener listener = new OnClickListener() { 

@Override 
public void onClick(View v) { 
switch (v.getld()) { 
case R.id.in: /如 果 是 缩小 %/ 
ctriMap.zoomIn(); 
break; 
case R.id.out: PUREHA 
ctriMap.zoomOut(); 
break; 
default: 
break; 
} 
} 


inBtn.setOnClickListener(listener); 

outBtn.setOnClickListener(listener); 

M ”通过 方法 onCheckedChanged(O) 获 取 是 否 选择 了 switchMap， 如 果 选 择 了 则 显示 卫星 地 图 。 首 先 
通过 方法 findViewById0 获 取 对 应 id 的 ToggleButton 对 象 的 引用 ， 然 后 调用 setOnChecked 
ChangeListener0 方 法 ， 设 置 对 事件 监听 器 选中 的 事件 进行 处 理 。 根 据 ToggleButton 是 否 被 选 
中 ， 进 而 通过 setSatellite0 方 法 启用 或 禁用 卫星 地 图 功能 。 具 体 代 码 如 下 : 

switchMap = (ToggleButton)findViewByld(R.id.switchMap); 

switchMap.setOnCheckedChangeListener(new OnCheckedChangeListener() { 

@Override 
public void onCheckedChanged(CompoundButton cBtn, boolean isChecked) { 
if (isChecked == true) { 
map.setSatellite(true); 
) else { 
map.setSatellite(false); 


} 
} 
D: 
通过 LocationManager 获取 当前 的 位 置 ， 然 后 通过 getBestProvider0 方 法 来 获取 和 查询 条 件 ， 
最 后 设置 更 新 位 置信 息 的 最 小 间隔 为 2 秒 ， 位 移 变化 在 10 米 以 上 。 具 体 代码 如 下 : 
© 


LocationManager locationManager; 
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String context = Context. LOCATION. SERVICE; 
locationManager = (LocationManager)getSystemService(context); 
//String provider = LocationManager.GPS PROVIDER; 


Criteria criteria = new Criteria(); 
criteria.setAccuracy(Criteria. ACCURACY FINE); 
criteria.setAltitudeRequired(false); 
criteria.setBearingRequired(false); 

criteria.setCostAllowed(true); 
criteria.setPowerRequirement(Criteria.POWER LOW); 

String provider = locationManager.getBestProvider(criteria, true); 


Location location = locationManager.getLastKnownLocation(provider); 
updateWithNewLocation(location); 
locationManager.requestLocationUpdates(provider, 2000, 10, 
locationListener); 
} 
м ”设置 回调 方法 何 时 被 调用 ， 具 体 代 码 如 下 : 
private final LocationListener locationListener = new LocationListener() { 
public void onLocationChanged(Location location) { 
updateWithNewLocation(location); 
} 
public void onProviderDisabled(String provider){ 
updateWithNewLocation(null); 
} 
public void onProviderEnabled(String provider){ } 
public void onStatusChanged(String provider, int status, 
Bundle extras){ } 
ү 
定义 方法 update WithNewLocation(Location location) 来 显示 地 理 信息 和 地 图 信息 , 具体 代码 如 下 : 
private void updateWithNewLocation(Location location) { 
String latLongString; 
TextView myLocationText; 
myLocationText = (TextView)findViewByld(R.id.myLocationText); 
if (location != null) { 
double lat = location.getLatitude(); 
double Ing = location.getLongitude(); 
latLongString = "纬度 是 :" + lat + "n 经 度 是 :" + Ing; 


ctriMap.animateTo(new GeoPoint((int)(lat*1E6),(int)(Ing*1E6))); 
}else { 
latLongString = "获取 失败 "; 


} 
myLocationText.setText(" 当 前 的 位 置 是 :\n" + 
latLongString); 


} 
} 
至 此 ， 整 个 实例 全 部 介绍 完毕 ， 在 图 9-10 中 选 定 一 个 经 度 和 纬度 位 置 后 ， 可 以 显示 此 位 置 的 定位 
信息 ， 并 且 定 位 信息 分 别 以 文字 和 地 图 的 形式 显示 出 来 ， 如 图 9-11 所 示 。 
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单 击 “ 放 大 地 图 ”和 “缩小 地 图 ”按钮 后 ， 能 控制 地 图 的 大 小 显示 ， 如 图 9-12 所 示 。 打 开 卫 星 视 
图 后 ， 可 以 显示 此 位 置 范 围 对 应 的 卫星 地 图 ， 如 图 9-13 所 示 。 
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图 9-12 放大 后 效果 图 9-13 卫星 地 图 
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在 Android 系统 中 ， 可 以 使 用 LocationManager 来 设置 接近 警报 功能 。 此 功能 和 本 章 前 面 讲解 的 地 
图 定位 功能 类 似 ， 但 是 可 以 在 物 联网 设备 进入 或 离开 某 一 个 指定 区 域 时 发 送 通知 应 用 ， 而 并 不 是 在 新 
位 置 时 才 发 送 通知 程序 。 本 节 将 详细 讲解 在 Android 系统 中 实现 接近 警报 应 用 的 方法 。 


9.4.1 类 Geocoder 基础 


在 现实 世界 中 ， 地 图 和 定位 服务 通常 使 用 经 纬度 来 精确 地 指出 地 理 位 置 。 在 Android 系统 中 ， 提 
供 了 地 理 编 码 类 Geocoder 来 转换 经 纬度 和 现实 世界 的 地 址 。 地 理 编 码 是 一 个 街道 、 地 址 或 者 其 他 位 置 
(经 度 、 纬 度 ) 转化 为 坐标 的 过 程 。 反 向 地 理 编码 是 将 坐标 转换 为 地 址 经度、 纬度) 的 过 程 。 一 组 
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反 向 地 理 编码 结果 间 可 能 会 有 所 差异 。 例 如 在 一 个 结果 中 可 能 包含 最 临近 建筑 的 完整 街道 地 址 ， 而 另 
一 个 可 能 只 包含 城市 名 称 和 邮政 编码 。Geocoder 要 求 的 后 端 服务 并 没有 包含 在 基本 的 Android 框架 中 。 
如 果 没有 此 后 端 服 务 ， 执 行 Geocoder 的 查询 方法 将 返回 一 个 空 列表 。 使 用 isPresent0 方 法 ， 以 确定 
Geocoder 是 否 能 够 正常 执行 。 

在 Android 系统 中 ， 类 Geocoder 的 继承 关系 如 下 : 

public final class Geocoder extends Object 

java.lang.Object 

android.location.Geocoder 


在 Android 系统 中 ， 类 Geocoder 的 主要 功能 如 下 所 示 。 
(1) 设置 模拟 器 以 支持 定位 服务 
GPS 数据 格式 有 GPX fll KML 两 种 ， 其 中 GPX 是 一 个 XML 格式 文件 ， 为 应 用 软件 设计 的 通用 的 
GPS 数据 格式 ， 可 以 用 来 描述 路 点 、 轨 迹 和 路 程 。 而 KML 是 基于 XML (eXtensible Markup Language, 
可 扩展 标记 语言 ) 语法 标准 的 一 种 标记 语言 (Markup Language)， 采 用 标记 结构 ， 含 有 嵌 套 的 元 素 和 
属性 。 由 Google 旗下 的 Keyhole 公司 发 展 并 维护 ， 用 来 表达 地 理 标 记 。 
LBS 是 Location Based Service 的 缩写 , 是 一 个 总 称 ,用 来 描述 用 于 找到 设备 当前 位 置 的 不 同 技术 。 
主要 包含 如 下 所 示 的 两 个 元 素 。 
回 locationManager: 用 于 提供 LBS 7 hook, KAMAE, FREE, W AJM DR 
定 区 域 的 接近 警报 。 
LocationProviders: 提供 多 种 定位 方式 供 开 发 者 选择 ,常用 的 定位 方式 有 GPS (GPS_PROVIDER) 
定位 和 NETWORK(NETWORK_PROVIDER) 定位 。 
String providerName =LocationManager.GPS_PROVIDER; 


LocationProvidergpsProvider; 
gpsProvider =locationManager.getProvider(providerName); 


在 Eclipse 开发 环境 中 ， 依 次 选择 DDMS | Location Controls 命令 可 以 设置 位 置 变化 数据 ， 以 在 模 
拟 器 中 测试 应 用 程序 ， 如 图 9-14 所 示 。 使 用 ManualTab， 可 以 指定 特定 的 纬度 /经 度 对 。 另 外 ，KML 
和 GPX 可 以 载 入 KML 和 GPX 文件, 一旦 加 载 , 可 以 跳 转 到 特定 的 航 点 (位置) 或 顺序 播放 每 个 位 置 。 
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也 可 以 用 类 Criteria 设置 符合 要 求 的 Provider 的 条 件 查询 (精度 = 精确 /粗略 , 能 耗 = 高 /中 / 低 , 成 本 ， 
返回 海拔 ， 速 度 ， 方 位 的 能 力 )， 例 如 下 面 的 代码 。 

Criteria criteria = newCriteria(); 

criteria.setAccuracy(Criteria ACCURACY_COARSE); 


@ 
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criteria.setPowerRequirement(Criteria.POWER LOW); 

criteria.setAltitudeRequired(false); 

criteria.setBearingRequired(false); 

criteria.setSpeedRequired(false); 

criteria.setCostAllowed(true); 

String bestProvider = locationManager.getBestProvider(criteria, true);// 或 者 用 getProviders 返回 所 有 可 能 匹配 的 

Provider 

List<String>matchingProviders = locationManager.getProviders(criteria false); 

在 使 用 LocationManager 前 ， 需 要 将 uses-permission 加 到 manifest 文件 中 以 支持 对 LBS 硬件 的 访 

la]. GPS 需要 finepermission 权限 ，Network 需要 coarsepermission 权限 。 
<uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/> 

«uses-permissionandroid:name-"android.permission. ACCESS_COARSE_LOCATION"/> 

使 用 getLastKnownLocation() 方 法 可 以 获得 最 新 的 位 置 。 

String provider =LocationManager.GPS_PROVIDER; 

Location location = locationManager.getLastKnownLocation(provider); 

(2) 跟踪 运动 (TrackingMovement) 

加 ”可 以 使 用 requestLocationUpdates0 方 法 取得 最 新 的 位 置 变 化 , 为 优化 性 能 可 指定 位 置 变 化 的 最 
小 时 间 (毫秒 ) 和 最 小 距离 〈 米 )。 当 超出 最 小 时 间 和 距离 值 时 ，Location Listener 将 触发 
onLocationChanged 事件 。 

locationManager.requestLocationUpdates(provider,t, distance,myLocationListener); 

М ”用 RomoveUpdates() 方 法 停止 位 置 更 新 。 

М KBR GPS 硬件 都 明显 地 消耗 电能 。 

(3) 邻近 警告 (Proximity Alerts) 

通过 邻近 警告 功能 让 应 用 程序 设置 触发 器 ， 当 用 户 在 地 理 位 置 上 移动 或 超出 设 定 距 离 时 触发 。 

加 ”可 用 PendingIntent 定义 Proximity Alert 触发 时 广播 的 Intent. 

М ”为 了 处 理 proximityalert， 需 要 创建 BroadcastReceiver， 并 重 写 onReceive0 方 法 。 例 如 下 面 的 
代码 。 

public classProximityIntentReceiver extends BroadcastReceiver { 

@Override 

public void onReceive(Context context, Intent intent) { 

String key =LocationManager.KEY_PROXIMITY_ENTERING; 
Booleanentering = intent.getBooleanExtra(key, false); 

[ ...perform proximity alert actions ... ] 

} 

} 

要 想 启 动 监听 ， 需 要 注册 这 个 Receiver. 

IntentFilter filter =new IntentFilter(TREASURE_PROXIMITY_ALERT); 

registerReceiver(newProximitylntentReceiver(), filter); 


9.4.2 Geocoder 的 公共 构造 器 和 公共 方法 


在 Android 系统 中 ， 类 Geocoder 包含 了 如 下 所 示 的 公共 构造 器 。 
(1) public Geocoder(Context context, Local local): 3) 能 是 根据 给 定 的 语言 环境 构造 一 个 Geocoder 
对 象 。 各 个 参数 的 具体 说 明 如 下 。 
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context: 当前 的 上 下 文 对 象 。 
local: 当前 语言 环境 。 

(2) public Geocoder(Context context): 功能 是 根据 给 定 的 系统 默认 语言 环境 构造 一 个 Geocoder 对 
象 。 参 数 context 表示 当前 的 上 下 文 对 象 。 

在 Android 系统 中 ， 类 Geocoder 包含 了 如 下 所 示 的 公共 方法 。 

(1) public List<Address>getFromLocation(double latitude, double longitude, int maxResults): 功能 是 
根据 给 定 的 经 纬度 返回 一 个 描述 此 区 域 的 地 址 数组 。 返 回 的 地 址 将 根据 构造 器 提供 的 语言 环境 进行 本 
地 化 。 

返回 值 : 一 组 地 址 对 象 ， 如 果 没 有 找到 匹配 项 ， 或 者 后 台 服 务 无 效 的 话 则 返回 null 或 者 空 序列 。 
也 可 能 通过 网 络 获取 ， 返 回 结果 是 一 个 最 好 的 估计 值 ， 但 不 能 保证 其 完全 正确 。 

各 个 参数 的 具体 说 明 如 下 。 

回 latitude: 纬度 。 

回 longitude: 经 度 。 

E] maxResults: 要 返回 的 最 大 结果 数 ， 推 荐 1 一 5。 

包含 的 异常 如 下 。 

回 IllegalArgumentException: 纬度 小 于 -90 或 者 大 于 90。 

回 IllegalArgumentException: 经 度 小 于 -180 或 者 大 于 180. 

M IOException: 如 果 没 有 网 络 或 者 IO 错误 。 

(2) public List<Address>getFromLocationName(String locationName, int maxResults, double lower 
LeftLatitude, double lowerLeftLongitude, double upperRightLatitude, double upperRightLongitude): 功能 是 
返回 一 个 由 给 定 的 位 置 名 称 参 数 所 描述 的 地 址 数组 。 名 称 参数 可 以 是 一 个 位 置 名 称 ， 例 如 “Dakik, 
Iceland”， 也 可 以 是 一 个 地 址 ， 例 如 “1600 Amphitheatre Parkway, Mountain View, CA”， 也 可 以 是 一 
机 场 代号 ， 例 如 “SFO”…… 返回 的 地 址 将 根据 构造 器 提供 的 语言 环境 进行 本 地 化 。 

也 可 以 指定 一 个 搜索 边界 框 ， 该 边界 框 由 左下 方 坐标 经 纬度 和 右上 方 坐标 经 纬度 确定 。 
返回 值 : 一 组 地 址 对 象 ， 如 果 没 有 找到 匹配 项 ， 或 者 后 台 服 务 无 效 的 话 则 返回 null 或 者 空 序列 。 
也 有 可 能 是 通过 网 络 获取 。 返 回 结果 是 一 个 最 好 的 估计 值 ， 但 不 能 保证 其 完全 正确 。 通 过 UI 主线 程 的 
后 台 线 程 来 调用 这 个 方法 可 能 更 加 有 用 。 
各 个 参数 的 具体 说 明 如 下 。 
locationName: 用 户 提供 的 位 置 描述 。 
maxResults: 要 返回 的 最 大 结果 数 ， 推 荐 1 一 5。 
lowerLeftLatitude: 左下 角 纬度 ， 用 来 设 定 矩 形 范围 。 
lowerLefiLongitude: 左下 角 经 度 ， 用 来 设 定 和 矩形 范围 。 
upperRightLatitude: 右上 角 纬 度 ， 用 来 设 定 矩 形 范 围 。 
upperRightLongitude: 右上 角 经 度 ， 用 来 设 定 矩 形 范围 。 
含 的 异常 如 下 。 
IllegalArgumentException: 如 果 位 置 描 述 为 空 。 
IllegalArgumentException: 如 果 纬 度 小 于 -90 或 者 大 于 90. 
IllegalArgumentException: 如 果 经 度 小 于 -180 或 者 大 于 180。 
IOException: 如 果 没 有 网 络 或 者 IO 错误 。 
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(3) public List<Address>getFromLocationName(String locationName, int maxResults): 功能 是 返回 
一 个 由 给 定 的 位 置 名 称 参数 所 描述 的 地 址 数组 。 名 称 参 数 可 以 是 一 个 位 置 名 称 , 例如 “Dalvik, Iceland”, 
也 可 以 是 一 个 地 址 ， 例 如 “1600 Amphitheatre Parkway, Mountain View, CA ”， 也 可 以 是 一 个 机 场 代号 ， 
例如 “SFO” 返回 的 地 址 将 根据 构造 器 提供 的 语言 环境 进行 本 地 化 。 在 现实 应 用 中 ， 通 过 UI 主线 程 
的 后 台 线 程 来 调用 这 个 方法 可 能 会 更 加 有 用 。 

返回 值 : 一 组 地 址 对 象 ， 如 果 没 有 找到 匹配 项 ， 或 者 后 台 服 务 无 效 的 话 则 返回 null 或 者 空 序列 。 
也 有 可 能 是 通过 网 络 获取 。 返 回 结果 是 一 个 最 好 的 估计 值 ， 但 不 能 保证 其 完全 正确 。 

各 个 参数 的 具体 说 明 如 下 。 

М locationName: 用 户 提供 的 位 置 描述 。 

E] maxResults: 要 返回 的 最 大 结果 数 ， 推 荐 1 一 5。 

包含 的 异常 如 下 。 

E] JllegalArgumentException: 如 果 位 置 描述 为 空 。 

M IOException: 如 果 没 有 网 络 或 者 IO 错误 。 

(4) public static boolean isPresent(): 如 果 Geocoder 的 方法 getFromLocation0 和 方法 getFrom 
LcationName0) 都 实现 ， 则 返回 true。 当 没有 网 络 连接 时 ， 这 些 方法 仍然 可 能 返回 空 值 或 者 空 序 列 。 


943 ”实战 演练 一 一 接近 某 个 位 置 时 实现 自动 提醒 
本 实例 的 功能 是 当 穿 戴 设 备 接近 某 个 位 置 时 实现 自动 提醒 。 本 实例 源码 是 开源 代码 ， 来 源 于 地 址 


https://github.com/gast-lib/gast-lib， 读 者 可 以 自行 登录 并 下 载 。 


本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 主 界面 GeocodeActivity 用 于 从 用 户 处 获取 目标 位 置 的 信息 ， 并 使 用 LocationManager 对 
象 对 位 置 进 行 编 码 处 理 。 主 界面 GeocodeActivity 的 布局 文件 是 geocode.xml, 功能 是 供用 户 选 择 一 个 目 
标 位 置信 息 ， 具 体 实现 代码 如 下 : 
<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" > 


<TextView android:id="@+id/enterLocationLabel" 
android:layout_height="wrap_content" 
android:layout_width="wrap_content" 
android:text="@string/enterLocationLabel" 
android:layout alignParentTop-"true" /> 


«EditText android:id="@+id/enterLocationValue" 
android:layout height-"wrap content" 
android:layout width-"match parent" 
android:layout below-"(giid/enterLocationLabel" 
android:text-"springfield" /> 
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«Button android:id="@+id/lookupLocationButton" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/lookupLocationButton" 
android:layout_below="@id/enterLocationValue" 
android:onClick="onLookupLocationClick" /> 


«Button android:id="@+id/okButton" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:text="@android:string/ok" 
android:onClick="onOkClick" /> 

<ListView android:id="@android:id/list" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:drawSelectorOnTop-"false" 
android:layout_above="@id/okButton" 
android:layout_below="@id/lookupLocationButton" 
android:choiceMode="singleChoice" /> 

</RelativeLayout> 


主 界面 GeocodeActivity 的 的 程序 文件 是 GeocodeActivityjava， 功 能 是 对 设备 中 提供 的 地 址 实现 地 
理 编码 和 反 向 地 理 编 码 处 理 。 当 单 击 Lookup Location 按钮 时 会 运行 onLookupLocationClick0 方 法 ， 在 


此 方法 中 调用 了 类 Geocode. 3 GeocodeActivity.java 的 具体 实现 代码 如 下 : 
public class GeocodeActivity extends ListActivity 


{ 
private static final String TAG = "GeocodeActivity"; 
private static final int MAX ADDRESSES - 30; 


@Override 
protected void onCreate(Bundle savedinstanceState) 


{ 


super.onCreate(savedinstanceState); 


setContentView(R.layout.geocode); 


} 
public void onLookupLocationClick(View view) 
: if (Geocoder.isPresent()) 
: EditText addressText = (EditText) findViewByld(R.id.enterLocationValue); 
try 
{ 


List<Address> addressList = new Geocoder(this).getFromLocationName(addressText. getText(). 


toString(), MAX ADDRESSES); 


List<AddressWrapper> addressWrapperList = new ArrayList<AddressWrapper>(); 
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for (Address address : addressList) 
Í 

addressWrapperList.add(new AddressWrapper(address)); 
) 


setListAdapter(new ArrayAdapter<AddressWrapper>(this, android.R.layout.simple_list_item_ 
single_choice, addressWrapperList)); 
} 
catch (IOException e) 


í 
Log.e(TAG, "Could not geocode address”, e); 


new AlertDialog.Builder(this) 
.SetMessage(R.string.geocodeErrorMessage) 
-SetTitle(R.string.geocodeErrorTitle) 
-setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() 


{ 
@Override 
public void onClick(DialogInterface dialog, int which) 
{ 
dialog.dismiss(); 
} 
}).show(); 


} 


public void onOkClick(View view) 


{ 
ListView listView = getListView(); 


Intent intent = getintent(); 
if (listView.getCheckedltemPosition() != ListView.INVALID_POSITION) 


AddressWrapper addressWrapper = (AddressWrapper)listView.getltemAtPosition (listView. 
getCheckedltemPosition()); 


intent.putExtra("name", addressWrapper.toString()); 

intent.putExtra("latitude", addressWrapper.getAddress().getLatitude()); 

intent.putExtra("longitude", addressWrapper.getAddress().getLongitude()); 
] 


this.setResult(RESULT_OK, intent); 
finish(); 
) 


private static class AddressWrapper 


{ 


private Address address; 
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public AddressWrapper(Address address) 


{ 
this.address = address; 
} 
@Override 
public String toString() 
{ 
StringBuilder stringBuilder = new StringBuilder(); 
for (int i = 0; i < address.getMaxAddressLinelndex(); i++) 
{ 
stringBuilder.append(address.getAddressLine(i)); 
if ((i + 1) < address.getMaxAddressLinelndex()) 
stringBuilder.append(", "); 
} 
} 
return stringBuilder.toString(); 
} 
public Address getAddress() 
{ 
return address; 
} 
} 
} 
在 上 述 代码 中 ， 调 用 方法 isPresentO 检 验 当 前 设备 是 否 支持 地 理 编码 和 反 向 地 理 编 码 功能 。 方 法 


fromLocationName() 能 够 解析 输入 的 位 置 字符 串 和 标志 性 建筑 的 坐标 , 这 一 功能 是 通过 网 络 查询 来 实现 
的 。 得 到 查询 结果 后 ， 会 在 下 方 使 用 ListView 列表 进行 展示 。 

(2) 开始 实现 接近 警报 设置 界面 ， 此 功能 通过 LocationManager 实现 。 接 近 警 报 设置 界面 的 布局 
文件 是 proximity_alertxml， 提 供 了 两 个 单 选 按钮 供用 户 选择 设置 类 型 ， 并 且 可 以 设置 允许 的 接近 读 取 
半径 值 。 文 件 proximity alert.xml 的 具体 实现 代码 如 下 : 

<RelativeLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 


«TextView android:id="@+id/locationLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/locationLabel" 
android:layout_alignParentTop="true" 
android:layout alignParentLeft-"true" 
style="@style/apptext" /> 
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<TextView android:id="@+id/locationValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_alignTop="@id/locationLabel" 
android:layout_toRightOf="@id/locationLabel" 
android:text="@string/none” 
android:paddingLeft="5dip" 
style="@style/apptext" /> 


<TextView android:id="@+id/latitudeLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/latitudeLabel" 
android:layout_below="@id/locationValue" 
android:layout_alignParentLeft="true" 
style="@style/apptext" /> 


<TextView android:id="@+id/latitudeValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_alignTop="@id/latitudeLabel" 
android:layout_toRightOf="@id/latitudeLabel" 
android:text="@string/none" 
android:paddingLeft="5dip" 
style="@style/apptext" /> 


«TextView android:id="@+id/longitudeLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/longitudeLabel" 
android:layout below-"giid/latitudeLabel" 
android:layout alignParentLeft-"true" 
style="@style/apptext" /> 


«TextView android:id="@+id/longitudeValue" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:layout_alignTop="@id/longitudeLabel" 
android:layout_toRightOf="@id/longitudeLabel” 
android:text="@string/none" 
android:paddingLeft="5dip" 
style="@style/apptext" /> 


<TextView android:id="@+id/radiusLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/radiusLabel" 
android:layout_below="@id/longitudeLabel" 
android:layout alignParentLeft-"true" 
style="@style/apptext" /> 
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<EditText android:id="@+id/radiusValue" 


android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_alignTop="@id/radiusLabel" 
android:layout_toRightOf="@id/radiusLabel" 
android:text="10" 
android:paddingLeft="5dip" 
style="@style/apptext" 
android:inputType="number" /> 


<Button 


android:layout height-"wrap content" 
android:layout width-"match parent" 
android:text="@string/setLocation" 
android:onClick="onSetLocationClick" 
android:layout_below="@id/radiusValue" /> 


<LinearLayout android:id="@+id/buttons" 


android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
android:layout alignParentBottom-"true" > 


«Button android:id="@+id/setProximityAlert" 
android:layout height-"wrap content" 
android:layout width-"match parent" 
android:text="@string/setProximityAlert" 
android:onClick="onSetProximityAlertClick" 
android:enabled-"false" 
android:layout_weight="1" /> 


«Button android:id="@+id/clearProximityAlert" 
android:layout_height="wrap_content" 
android:layout_width="match_parent" 
android:text="@string/clearProximityAlert" 
android:onClick-"onClearProximityAlertClick" 
android:enabled-"false" 
android:layout_weight="1" /> 


</LinearLayout> 


<RadioGroup android:id="@+id/proximityTypeRadioGroup" 


android:layout height-"wrap content" 
android:layout width-"match parent" 
android:orientation-"horizontal" 
android:layout_above="@id/buttons" > 


<RadioButton android:id="@+id/androidProximityAlert" 
android:layout height-"wrap content" 
android:layout width-"wrap content" 


android:text="@string/androidProximityAlertT ypeLabel" 


android:layout_weight="1" 
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style="@style/apptext" /> 
<RadioButton android:id="@+id/customProximityAlert" 

android:layout height-"wrap content" 
android:layout width-"wrap content" 
android:text="@string/customProximityAlertT ypeLabel" 
android:layout_weight="1" 
style="@style/apptext" /> 

</RadioGroup> 


<TextView 
android:layout_above="@id/proximityTypeRadioGroup" 
style="@style/apptext" 
android:text="Select Proximity Alert Type" /> 
</RelativeLayout> 


接近 警报 设置 界面 的 Activity 是 ProximityAlertActivityjava， 具 体 实现 流程 如 下 : 

首先 通过 onSetProximityAlertClick 读 取 输 入 的 半径 值 ， 当 来 到 预定 目标 的 这 一 半径 范围 之 内 
时 会 发 出 警报 。 

M ” 读 取 半 径 值 后 调用 locationManager.addProximityAlert 来 传递 坐标 、 半 径 、 失 效 和 广播 Intent 

等 参数 。 

编写 方法 onClearProximityAlertClickO 用 于 处 理 单 击 Clear Proximity Alert 按钮 的 动作 , 可 以 在 

不 需要 时 关闭 接近 警报 功能 ， 这 样 做 的 好 处 是 可 以 避免 这 个 接近 警报 过 期 。 

public class ProximityAlertActivity extends Activity 

{ 


Q 


private static final String USE ANDROID PROXIMITY TYPE KEY = "useAndroidProximityTypeKey"; 


private LocationManager locationManager; 

private PendingIntent pendinglntent; 

private SharedPreferences preferences; 

private RadioButton androidProximityTypeRadioButton; 
private Button setProximityAlert; 

private Button clearProximityAlert; 

private double latitude = Double. MAX_VALUE; 

private double longitude = Double. MAX_VALUE; 


@Override 
protected void onCreate(Bundle savedinstanceState) 


{ 
super.onCreate(savedlInstanceState); 
setContentView(R.layout.proximity alert); 
locationManager 7 (LocationManager) getSystemService(LOCATION SERVICE); 
pendingIntent = ProximityPendingIntentFactory.createPendingIntent(this); 
preferences = getPreferences(MODE_PRIVATE); 
androidProximityTypeRadioButton = 

(RadioButton)findViewByld(R.id.androidProximityAlert); 


setProximityAlert = (Button) findViewByld(R.id.setProximityAlert); 
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clearProximityAlert = (Button) findViewByld(R.id.clearProximityAlert); 


} 
@Override 
protected void onResume() 
{ 
super.onResume(); 
if (preferences.getBoolean(USE ANDROID PROXIMITY TYPE KEY, true)) 
{ 
androidProximityTypeRadioButton.setChecked(true); 
} 
else 
((RadioButton)findViewByld(R.id.customProximityAlert)).setChecked(true); 
} 
} 
@Override 
protected void onPause() 
{ 
super.onPause(); 


locationManager.removeProximityAlert(pendingIntent); 
preferences.edit().putBoolean(USE ANDROID PROXIMITY TYPE KEY, androidProximityType Radio 
Button.isChecked()).commit(); 


public void onSetProximityAlertClick(View view) 
EditText radiusView = (EditText)findViewByld(R.id.radiusValue); 
int radius = 
Integer.parselnt(radiusView.getText().toString()); 


if (androidProximityTypeRadioButton.isChecked()) 


{ 
locationManager.addProximityAlert(latitude, 

longitude, 
radius, 
-1, 
pendingintent); 

] 

else 

{ 


Criteria criteria = new Criteria(); 
criteria.setAccuracy(Criteria.ACCURACY COARSE); 

Intent intent = new Intent(this, ProximityAlertService.class); 
intent.putExtra(ProximityAlertService.LATITUDE INTENT. KEY, latitude); 
intent.putExtra(ProximityAlertService.LONGITUDE INTENT. KEY, longitude); 
intent.putExtra(ProximityAlertService.RADIUS INTENT KEY, (float)radius); 
startService(intent); 
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} 


setProximityAlert.setEnabled(false); 
clearProximityAlert.setEnabled(true); 


} 
public void onClearProximityAlertClick(View view) 
{ 
if (androidProximityTypeRadioButton.isChecked()) 
{ 
locationManager.removeProximityAlert(pendingIntent); 
} 
setProximityAlert.setEnabled(true); 
clearProximityAlert.setEnabled(false); 
} 


public void onSetLocationClick(View view) 


startActivityForResult(new Intent(this, GeocodeActivity.class), 1); 


} 
@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) 
{ 
super.onActivityResult(requestCode, resultCode, data); 
if (resultCode == RESULT_OK 
&& data != null 
&& data.hasExtra("name") 
&& data.hasExtra("latitude") 
&& data.hasExtra("longitude")) 
{ 
latitude = data.getDoubleExtra("latitude", Double: MAX_VALUE); 
longitude = data.getDoubleExtra("longitude", Double. MAX VALUE); 
((TextView)findViewByld(R.id.locationValue)).setT ext(data.getStringExtra("name")); 
((TextView)findViewByld(R.id.latitudeValue)).setT ext(String.valueOf(latitude)); 
((TextView)findViewByld(R.id.longitudeValue)).setText(String.valueOf(longitude)); 
setProximityAlert.setEnabled(true); 
ClearProximityAlert.setEnabled(false); 
} 
5 


} 
(3) 开始 实现 发 送 接近 警报 响应 信息 模块 。 当 穿戴 设备 进入 或 离开 预定 坐标 的 指定 半径 区 域 时 ， 
接近 警报 会 广播 发 送 一 个 Intent。 上 述 功能 是 通过 文件 ProximityAlertBroadcastReceiverjava 实现 的 , E 
要 代码 如 下 : 
public class ProximityAlertBroadcastReceiver extends LocationBroadcastReceiver 


{ 
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private static final int NOTIFICATION_ID = 9999; 
@Override 

public void onEnteringProximity(Context context) 
{ 


} 


displayNotification(context, "Entering Proximity"); 


@Override 
public void onExitingProximity(Context context) 


f 
displayNotification(context, "Exiting Proximity"); 
} 


private void displayNotification(Context context, String message) 


{ 
NotificationManager notificationManager = (NotificationManager)context.getSystemService(Context. 
NOTIFICATION_ SERVICE); 


Pendingintent pi = PendingIntent.getActivity(context, 0, new Intent(), 0); 


Notification notification = new Notification(R.drawable.icon, message, System.currentTimeMillis()); 
notification.setLatestEventInfo(context, "GAST", "Proximity Alert", pi); 


notificationManager.notify(NOTIFICATION ID, notification); 

| } 

这 样 当 设备 进入 和 离开 预定 义 区 域 时 ， 会 发 送 一 个 通知 信息 。 

(4) 因为 穿戴 设备 的 电池 通常 是 有 限 的 ， 而 接近 警报 功能 需要 长 时 间 开 启 ， 所 以 很 费 电 。 为 了 解 
决 上 述 局 限 性 ,在 接近 警报 设置 界面 中 提供 了 两 个 单 选 按钮 供用 户 选 择 设 置 类 型 ， 其 中 Custom 类 型 可 
供用 户 自 定 义 设置 。 编 写 文件 ProximityAlertActivityjava， 实 现 对 默认 接近 警报 的 优化 ， 不 但 限制 了 对 
GPS 的 使 用 ， 而 且 降 低 了 请 求 位 置 更 新 功能 的 频率 。 设 置 在 最 后 才 会 将 服务 注册 到 网 络 提供 者 ， 以 获 
取 位 置 更 新 功能 ， 这 样 可 以 长 时 间 使 用 网 络 提 供 者 ， 并 且 只 有 在 网 络 提供 者 无 法 对 设备 和 目标 区 域 之 
间 的 距离 做 出 准确 计算 的 情况 下 才 会 启用 GPS。 当 计算 完 两 者 的 距离 之 后 ， 需 要 通过 服务 来 确定 是 否 
要 广播 一 个 шеш 来 发 出 接近 警报 。 如 果 不 需 要 ， 则 取消 当前 位 置 的 更 新 请 求 ， 并 重新 计算 最 短 距 离 ， 
并 用 新 的 距离 来 注册 位 置 更 新 请 求 。 文 件 ProximityAlertActivity.java 的 具体 实现 代码 如 下 : 

public class ProximityAlertActivity extends Activity 

H 


private static final String USE_ANDROID_PROXIMITY_TYPE_KEY = "useAndroidProximityTypeKey"; 


private LocationManager locationManager; 

private Pendinglntent pendinglntent; 

private SharedPreferences preferences; 

private RadioButton androidProximityTypeRadioButton; 
private Button setProximityAlert; 

private Button clearProximityAlert; 

private double latitude = Double. MAX VALUE; 

private double longitude = Double.MAX VALUE; 
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@Override 
protected void onCreate(Bundle savedinstanceState) 


{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.proximity_alert); 


locationManager = (LocationManager) getSystemService(LOCATION_SERVICE); 
pendingIntent = ProximityPendingIntentFactory.createPendingIntent(this); 
preferences = getPreferences(MODE_PRIVATE); 
androidProximityTypeRadioButton = 
(RadioButton)findViewByld(R.id.androidProximityAlert); 


setProximityAlert = (Button) findViewByld(R.id.setProximityAlert); 
clearProximityAlert = (Button) findViewByld(R.id.clearProximityAlert); 


} 
@Override 
protected void onResume() 
| super.onResume(); 
if (preferences.getBoolean(USE ANDROID PROXIMITY TYPE KEY, true)) 
androidProximityTypeRadioButton.setChecked(true); 
s 
((RadioButton)findViewByld(R.id.customProximityAlert)).setChecked(true); 
i } 
@Override 
protected void onPause() 
í super.onPause(); 


locationManager.removeProximityAlert(pendinglntent); 
preferences.edit().putBoolean(USE_ANDROID_PROXIMITY_TYPE_KEY, 
androidProximityTypeRadioButton.isChecked()).commit(); 
} 


public void onSetProximityAlertClick(View view) 


{ 
EditText radiusView = (EditText)findViewByld(R.id.radiusValue); 
int radius = 
Integer.parselnt(radiusView.getT ext().toString()); 


if (androidProximityTypeRadioButton.isChecked()) 
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{ 
locationManager.addProximityAlert(latitude, 
longitude, 
radius, 
ih, 
pendingintent); 
) 
else 
{ 
Criteria criteria = new Criteria(); 
criteria.setAccuracy(Criteria ACCURACY_COARSE); 
Intent intent = new Intent(this, ProximityAlertService.class); 
intent.putExtra(ProximityAlertService.LATITUDE INTENT KEY, latitude); 
intent.putExtra(ProximityAlertService..ONGITUDE INTENT KEY, longitude); 
intent.putExtra(ProximityAlertService.RADIUS INTENT KEY, (float)radius); 
startService(intent); 
} 


setProximityAlert.setEnabled(false); 
clearProximityAlert.setEnabled(true); 


} 
public void onClearProximityAlertClick(View view) 
{ 
if (androidProximityTypeRadioButton.isChecked()) 
locationManager.removeProximityAlert(pendingIntent); 
} 
setProximityAlert.setEnabled(true); 
clearProximityAlert.setEnabled(false); 
} 
public void onSetLocationClick(View view) 
{ 
startActivityForResult(new Intent(this, GeocodeActivity.class), 1); 
} 
@Override 


protected void onActivityResult(int requestCode, int resultCode, Intent data) 


{ 
super.onActivityResult(requestCode, resultCode, data); 


if (resultCode == RESULT_OK 
&& data != null 
&& data.hasExtra("name") 
&& data.hasExtra("latitude") 
&& data.hasExtra("longitude")) 


latitude = data.getDoubleExtra("latitude", Double.MAX VALUE); 
longitude = data.getDoubleExtra("longitude", Double. MAX VALUE); 
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((TextView)findViewByld(R.id.locationValue)).setT ext(data.getStringExtra("name")); 
((TextView)findViewByld(R.id.latitudeValue)).setText(String.valueOf(latitude)); 
((TextView)findViewByld(R.id.longitudeValue)).setText(String.valueOf(longitude)); 


setProximityAlert.setEnabled(true); 
ClearProximityAlert.setEnabled(false); 
) 
| } 
至 此 ， 整 个 实例 介绍 完毕 。 对 于 本 实例 的 具体 实现 源码 ， 读 者 可 以 参阅 开源 站 点 的 源码 。 
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11 章光 线 传感器 和 磁场 传感器 


° 加 速度 传感器 、 方 向 传感器 和 陀螺 仪 传感器 
将 ”旋转 向 量 传感器 、 距 离 传感器 和 气压 传感器 
С 温度 传感器 和 湿度 传感器 


第 10 章 Android (ks REO 


传感器 是 近年 来 随 着 物 联网 这 一 概念 的 流行 而 推出 的 ， 现 在 人 们 已 经 逐渐 地 认识 了 传感器 这 一 概 
念 。 其 实 传感器 在 大 家 日 常 的 生活 中 经 常见 到 甚至 是 用 到 ， 例 如 楼 宇 的 声控 楼 梯 灯 和 马路 上 的 路 灯 等 。 
本 章 将 详细 讲解 Android 系统 中 传感器 系统 的 基本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


10.1 Android 传感器 系统 概述 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \Android 传感器 系统 概述 .avi 

在 Android 系统 中 提供 的 主要 传感器 有 加 速度 传感器 、 磁 场 、 方 向 、 陀 螺 仪 、 光 线 、 压 力 、 温 度 
和 接近 等 。 传 感 器 系统 会 主动 对 上 层 报告 传感器 精度 和 数据 的 变化 ， 并 且 提供 了 设置 传感器 精度 的 接 
口 ， 这 些 接口 可 以 在 Java 应 用 和 Java 框架 中 使 用 。 

Android 传感器 系统 的 基本 层次 结构 如 图 10-1 所 示 。 


Android 应 用 


本 地 框架 屏幕 方向 管理 
Sensor 的 Java 类 
Android 系 统 
douce 
SensorJNT 和 硬件 抽象 层 
T 
加 速度 、 磁 场 、 温 度 等 传感器 设备 硬件 和 驱动 


图 10-1 传感器 系统 的 层次 结构 


根据 图 10-1 所 示 的 结构 ，Android 传感器 系统 从 上 到 下 分 别 是 Java 应 用 层 、Java 框架 对 传感器 的 
应 用 、 传 感 器 类 、 传 感 器 硬件 抽象 层 和 传感器 驱动 。 图 10-1 中 各 个 层 的 具体 说 明 如 下 所 示 。 
(1) 传感器 系统 的 Java 部 分 ， 代 码 路 径 是 frameworks/base/include/core/java/android/hardware。 
此 部 分 对 应 的 实现 文件 是 Sensor* java, 
(2) 传感器 系统 的 INI 部 分 ， 代 码 路 径 是 frameworks/base/core/jni/android hardware Sensor 
Мапарег.срр. 
在 此 部 分 中 提供 了 对 类 android.hardware.Sensor.Manage 的 本 地 支持 。 
(3) 传感器 系统 HAL 层 ， 头 文件 路 径 是 hardware/libhardware/include/hardware/sensors.h e 
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在 Android 系统 中 ， 传 感 器 系统 的 硬件 抽象 层 需要 特意 编码 实现 。 
(4) 驱动 层 ， 代 码 路 径 是 kernel/driver/hwmon/$(PROJECT)/sensor. 
ТЕЕ sensor.so 中 提供 了 如 下 所 示 的 8 个 API 函数 。 
控制 方面 :在 结构 体 ensors control device t 中 定义 ， 包 括 如 下 所 示 的 函数 。 
> int(*open data source)(struct sensors_control_device_t *dev) 
>  int(*activate)(struct sensors control device t *dev, int handle, int enabled) 
>  int(*set delay)(struct sensors control device t *dev, int32 t ms) 
>  int(*wake)(struct sensors control device t *dev) 
数据 方面 : 在 结构 体 sensors data device t 中 定义 ， 包 括 如 下 所 示 的 函数 。 
>  int(*data open)(struct sensors data device t *dev, int fd) 
>  int(*data close)(struct sensors data device t *dev) 
>  int(*poll)(struct sensors data device t *dev, sensors data t* data) 
模块 方面 : 在 结构 体 sensors module t 中 定义 ， 包 括 如 下 一 个 函数 。 
>  int(*get sensors list)(struct sensors module t* module, struct sensor t const** list) 
在 Android 系统 的 Java JAP, Sensor 的 状态 是 由 SensorService 来 负责 控制 的 ， 其 Java 代码 和 INI 
代码 分 别 位 于 如 下 文件 中 。 


frameworks/base/services/java/com/android/server/SensorService.java 


frameworks/base/services/jni/com android server SensorService.cpp 

SensorManager 负责 在 Java JÆ Sensor 的 数据 控制 , 它 的 Java 代码 和 INI 代码 分 别 位 于 如 下 文件 中 。 

frameworks/base/core/java/android/hardware/SensorManager.java 

frameworks/base/core/jni/android_hardware_SensorManager.cpp 

在 Android 的 Framework 中 ， 是 通过 文件 sensorService.java 和 sensorManager.java 实现 与 Sensor 
传感器 通信 的 。 文 件 sensorService.java 的 通信 功能 是 通过 INI 调用 sensorService.cpp 中 的 方法 实现 的 。 

文件 sensorManagerjava 的 具体 通信 功能 是 通过 INI 调用 sensorManagercpp 中 的 方法 实现 的 。 文 件 
sensorService.cpp 和 sensorManager.cpp 通过 文件 hardware.c 与 sensor.so 通信 。 其 中 文件 sensorService.cpp 
实现 对 sensor 的 状态 控制 ， 文 件 sensorManager.cpp 实现 对 sensor 的 数据 控制 。 

J£ sensor.so iti ioctl 控制 sensor driver 的 状态 ,通过 打开 sensor driver 对 应 的 设备 文件 读 取 G-sensor 
采集 的 数据 。 


10.2. Java 层 详 解 


ERU 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 10 章 \Java 层 详解 .avi 

在 Android 系统 中 ， 传 感 器 系统 的 Java 部 分 的 实现 文件 是 \sdk\apps\SdkControllen\src\com\android\ 
tools\sdkcontroller\activities\SensorActivity.javao 

通过 阅读 文件 SensorActivity.java 的 源码 可 知 , 在 应 用 程序 中 使 用 传感器 需要 用 到 hardware 包 中 的 


SensorManager. SensorListener 等 相关 的 类 ， 具 体 实现 代码 如 下 : 
public class SensorActivity extends BaseBindingActivity 
implements android.os.Handler.Callback { 


88) 


378 


Android 物 联 网 开发 从 入 门 到 实战 


@SuppressWarnings("hiding") 
public static String TAG = SensorActivity.class.getSimpleName(); 
private static boolean DEBUG = true; 


private static final int MSG_UPDATE_ACTUAL_HZ = 0x31415; 


private TableLayout mTableLayout; 
private TextView mTextError; 

private TextView mTextStatus; 

private TextView mTextTargetHz; 

private TextView mTextActualHz; 

private SensorChannel mSensorHandler; 


private final Map«MonitoredSensor, DisplayInfo> mDisplayedSensors = 
new HashMap<SensorChannel.MonitoredSensor, SensorActivity.Displaylnfo>(); 
private final android.os.Handler mUiHandler = new android.os.Handler(this); 
private int mTargetSampleRate; 
private long mLastActualUpdateMs; 


/第 一 次 创建 Activity 时 调用 */ 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.sensors); 
mTableLayout = (TableLayout) findViewByld(R.id.tableLayout); 
mTextError = (TextView) findViewByld(R.id.textError); 
mTextStatus = (TextView) findViewByld(R.id.textStatus); 
mTextTargetHz = (TextView) findViewByld(R.id.textSampleRate); 
mTextActualHz = (TextView) findViewByld(R.id.textActualRate); 
updateStatus("Waiting for connection"); 


mTextTargetHz.setOnKeyListener(new OnKeyListener() { 


@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
updateSampleRate(); 
return false; 
} 
}; 
mTextTargetHz.setOnFocusChangeListener(new OnFocusChangeListener() { 
@Override 
public void onFocusChange(View v, boolean hasFocus) { 
updateSampleRate(); 
} 
p; 
} 
@Override 


protected void onResume() { 
if (DEBUG) Log.d(TAG, "onResume"); 
//BaseBindingActivity 绑 定 后 台 服 务 
super.onResume(); 
updateError(); 


} 


(QOverride 

protected void onPause() { 
if (DEBUG) Log.d(TAG, "onPause"); 
super.onPause(); 


} 


@Override 

protected void onDestroy() { 
if (DEBUG) Log.d(TAG, "onDestroy"); 
super.onDestroy(); 
removeSensorUi(); 


@Override 

protected void onServiceConnected() { 
if (DEBUG) Log.d(TAG, "onServiceConnected"); 
createSensorUi(); 


} 


@Override 

protected void onServiceDisconnected() { 
if (DEBUG) Log.d(TAG, "onServiceDisconnected"); 
removeSensorUi(); 


} 


@Override 
protected ControllerListener createControllerListener() { 
return new SensorsControllerListener(); 


} 
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private class SensorsControllerListener implements ControllerListener { 


@Override 
public void onErrorChanged() { 
runOnUiThread(new Runnable() { 


@Override 
public void run() { 
updateError(); 
} 
D: 
} 
@Override 


public void onStatusChanged() { 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
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ControllerBinder binder 7 getServiceBinder(); 

if (binder != null) { 
boolean connected = binder.isEmuConnected(); 
mTableLayout.setEnabled(connected); 
updateStatus(connected ? "Emulated connected" : "Emulator disconnected"); 


}: 
} 


private void createSensorUi() { 
final Layoutinflater inflater = getLayoutinflater(); 


if (ImDisplayedSensors.isEmpty()) { 
removeSensorUi(); 


} 


mSensorHandler = (SensorChannel) getServiceBinder().getChannel(Channel.SENSOR CHANNEL); 
if (mSensorHandler !- null) ( 
mSensorHandler.addUiHandler(mUiHandler); 
mUiHandler.sendEmptyMessage(MSG UPDATE ACTUAL HZ); 


assert mDisplayedSensors.isEmpty(); 
List«MonitoredSensor» sensors = mSensorHandler.getSensors(); 
for (MonitoredSensor sensor : sensors) ( 
final TableRow row = (TableRow) inflater.inflate(R.layout.sensor row, 
mTableLayout, 
false); 
mTableLayout.addView(row); 
mDisplayedSensors.put(sensor, new DisplayInfo(sensor, row)); 


} 


private void removeSensorUi() { 

if (mSensorHandler != null) { 
mSensorHandler.removeUiHandler(mUiHandler); 
mSensorHandler = null; 

} 

mTableLayout.removeAllViews(); 

for (DisplayInfo info : mDisplayedSensors.values()) { 
info.release(); 

} 

mDisplayedSensors.clear(); 


private class DisplayInfo implements CompoundButton.OnCheckedChangeListener { 
private MonitoredSensor mSensor; 
private CheckBox mChk; 
private TextView mVal; 
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public DisplayInfo(MonitoredSensor sensor, TableRow row) ( 
mSensor = sensor; 


mChk = (CheckBox) row.findViewByld(R.id.row_checkbox); 
mChk.setText(sensor.getUiName()); 
mChk.setEnabled(sensor.isEnabledByEmulator()); 
mChk.setChecked(sensor.isEnabledByUser()); 
mChk.setOnCheckedChangeListener(this); 


/初始 化 显示 该 传感器 的 文本 框 
mVal = (TextView) row.findViewByld(R.id.row_textview); 
mVal.setText(sensor.getValue()); 


} 


p 
* 为 相关 的 复 选 框 选中 状态 进行 变化 处 理 。 当 复 选 框 被 选中 时 会 监听 传感器 变化 
* 如 果 不 加 以 控制 会 取消 传感器 的 变化 
M 
@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (mSensor != null) { 
mSensor.onCheckedChanged(isChecked); 


1 

} 

public void release() { 
mChk = null; 
mVal = null; 
mSensor = null; 

} 


public void updateState() { 
if (mChk != null && mSensor !- null) { 
mChk.setEnabled(mSensor.isEnabledByEmulator()); 
mChk.setChecked(mSensor.isEnabledByUser()); 


} 


public void updateValue() { 
if (mVal != null && mSensor != null) { 
mVal.setText(mSensor.getValue()); 
) 


) 


SCRA ARS EE FII 

@Override 

public boolean handleMessage(Message msg) { 
Displaylnfo info = null; 
switch (msg.what) { 
case SensorChannel.SENSOR_STATE_CHANGED: 


381 


Android 物 联 网 开发 从 入 门 到 实战 


info = mDisplayedSensors.get(msg.obj); 

if (info != null) { 
info.updateState(); 

} 

break; 

case SensorChannel.SENSOR_DISPLAY_MODIFIED: 

info = mDisplayedSensors.get(msg.obj); 

if (info != null) { 
info.updateValue(); 

} 

if (mSensorHandler != null) { 
updateStatus(Integer.toString(mSensorHandler.getMsgSentCount()) + " events sent"); 


// 如 果 值 已 经 修改 则 更 新 "actual rate" 
long ms = mSensorHandler.getActualUpdateMs(); 
if (ms != mLastActualUpdateMs) { 
mLastActualUpdateMs = ms; 
String hz = mLastActualUpdateMs <= 0 ? "--" : 
Integer.toString((int) Math.ceil(1000. / ms)); 
mTextActualHz.setText(hz); 
} 
} 
break; 
case MSG_UPDATE_ACTUAL_HZ: 
if (mSensorHandler != null) { 
// 如 果 值 已 经 修改 则 更 新 "actual rate" 
long ms = mSensorHandler.getActualUpdateMs(); 
if (ms != mLastActualUpdateMs) { 
mLastActualUpdateMs = ms; 
String hz = mLastActualUpdateMs <= 0 ? "--" : 
Integer.toString((int) Math.ceil(1000. / ms)); 
mTextActualHz.setText(hz); 


} 
mUiHandler.sendEmptyMessageDelayed(MSG_UPDATE_ACTUAL_HZ, 1000 /*1s*/); 
} 
} 
return true; 


} 


private void updateStatus(String status) { 
mTextStatus.setVisibility(status == null ? View.GONE : View.VISIBLE); 
if (status != null) mTextStatus.setText(status); 

} 


private void updateError() { 
ControllerBinder binder = getServiceBinder(); 
String error = binder == null ? "" : binder.getServiceError(); 
if (error == null) { 
error = ""; 


} 
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mTextError.setVisibility(error.length() == 0 ? View.GONE : View.VISIBLE); 
mTextError.setText(error); 


} 


private void updateSampleRate() { 
String str = mTextTargetHz.getText().toString(); 
try { 
int hz = Integer.parselnt(str.trim()); 


if (hz <= 0 || hz > 50) { 
hz = 50; 
} 


if (hz != mTargetSampleRate) { 
mTargetSampleRate = hz; 
if (mSensorHandler != null) { 
mSensorHandler.setUpdateTargetMs(hz <= 0 ? 0 : (int)(1000.0f / hz)); 
} 


} 
} catch (Exception ignore) {} 
} 


} 
通过 上 述 代 码 可 知 ， 整 个 Java 层 利用 大 家 熟悉 的 观察 者 模式 对 传感器 的 数据 进行 了 监听 处 理 。 


10.3 Frameworks 层 详 解 


а 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 10 章 \Frameworks 层 详解 .avi 

在 Android 系统 中 ，Frameworks 层 是 Android 系统 提供 的 应 用 程序 开发 接口 和 应 用 程序 框架 ， 与 
应 用 程序 的 调用 是 通过 类 实例 化 或 类 继承 进行 的 。 对 应 用 程序 来 说 ， 最 重要 的 就 是 把 SensorListener 注 
册 到 SensorManager 上 ， 从 而 才能 以 观察 者 身份 接收 到 数据 的 变化 ， 因 此 ， 我 们 把 目光 落 在 
SensorManager 的 构造 函数 、RegisterListener 函数 和 通知 机 制 相关 的 代码 上 。 在 Android 传感器 系统 中 ， 
Frameworks 层 的 代码 路 径 是 frameworks/base/include/core/java/android/hardware。 本 节 将 详细 讲解 传 感 
器 系统 的 Frameworks 层 的 具体 实现 流程 。 


10.3.1 监听 传感器 的 变化 


在 Android 传感器 系统 的 Frameworks 层 中 ， 文 件 SensorListenerjava 用 于 监听 从 Java 应 用 层 中 传 
递 过 来 的 变化 。 文 件 SensorListenerjava 比较 简单 ， 具 体 代码 如 下 : 
package android.hardware; 
@Deprecated 
public interface SensorListener { 
public void onSensorChanged(int sensor, float[] values); 
public void onAccuracyChanged(int sensor, int accuracy); 


} 
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10.3.2 ”注册 监听 


当 文 件 SensorListenerjava 监听 到 变化 之 后 , 会 通过 文件 SensorManagerjava 来 向 服务 注册 监听 变化 ， 
并 调度 Sensor 的 具体 任务 。 例 如 在 开发 Android 传感器 应 用 程序 时 ， 在 上 层 的 通用 开发 流程 如 下 所 示 。 
(1) 通过 getSystemServic(SENSOR. SERVICE): 语 句 得 到 传感器 服务 。 这 样 得 到 一 个 用 来 管理 分 
配 调度 处 理 Sensor 工作 的 SensorManager。SensorManager 并 不 服务 运行 于 后 台 ， 真正 属 于 Sensor 的 系 
统 服务 是 SensorService， 在 终端 下 的 #service list 中 可 以 看 到 sensorservice: [android.gui.Sensor Server]. 
(2) 通过 getDefaultSensor(Sensor.TYPE_GRAVITY); 语 句 得 到 传感器 类 型 ， 当 然 还 有 各 种 千 奇 百 
怪 的 传感器 ， 具 体 可 以 查阅 Android 官网 的 АРІ 或 者 源码 中 的 文件 Sensorjava。 
(3) 注册 监听 器 SensorEventListener。 在 应 用 程序 中 打开 一 个 监听 接口 ， 专 门 用 于 处 理 传感器 的 
数据 。 
(4) 通过 回调 函数 onSensorChanged 和 onAccuracyChanged 实现 实时 监听 。 例 如 对 重力 感应 器 的 
x、y、z 值 经 算法 变换 得 到 左右 、 上 下 、 前 后 方向 等 ， 就 由 这 个 回调 函数 实现 。 
综 上 所 述 ， 传 感 器 顶层 的 处 理 流程 如 图 10-2 所 示 。 


APP SensorManager 

[Sensor sensor = mSensorManager public Sensor getDefaultSensor()|frameworks/base/ 

|getSystemService(Sensor.TYPE_GRAVITY); 一 Icore/java/android/ 
[ListcSensor> = getsensorlist(typ! hardware/, 


SensorManager mSensorManager = public Sensor SensorManager{looper|SensorManager,java 
igetSystemService(SENSOR_SERVICE); 


nativeClassinit(); 


Ñ Public void run()( 


[Sensors, data. poll(sQueue,value;status, timestamp); 


Listener.onSensorChangedLocked(sensorObje 
\ct,values,timestamp,accuracy); 


Message msg = Message.obtain(); 
mHandle.sensorMessage(msg); 


\ListenerDelegate(listener, sensor, handler){ 
м Y ImHandler = new Handler(looper) {{ 
SensorEventListener Isn = new SensorEventListener() ( [public void handleMessage(Message msg) ( 
public void onSensorChanged(SensorEvent e) ( Ifinal SensorEvent t = (Sensorévent)msg.obj; 
[final int handle = t.sensor.getHandle(); 
public void onAccuracyChanged(Sensor s, int ji 


ered E нин еви mSensortventListener.onSensorChanged(t); 
= JERSE, RE Ë 
) 


for (ListenerDelegate i: sListeners) { 
if (i.-hasSensor(sensor)) { 


SensorManager 


图 10-2 ”传感器 顶层 的 处 理 流程 


文件 SensorManager.java 的 具体 实现 流程 如 下 : 


(1) 定义 类 SensorManager， 然 后 设置 各 种 传感器 的 初始 变量 值 ， 具 体 代 码 如 下 : 
public abstract class SensorManager { 
protected static final String TAG = "SensorManager"; 
private static final float] mTempMatrix = new float[16]; 


private final SparseArray<List<Sensor>> mSensorListByType = 


new SparseArray<List<Sensor>>(); 
e. 
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Private LegacySensorManager mLegacySensorManager; 
@Deprecated 

public static final int SENSOR_ORIENTATION = 1 << 0; 
@Deprecated 

public static final int SENSOR_ACCELEROMETER = 1 << 1; 
@Deprecated 

public static final int SENSOR_TEMPERATURE = 1 << 2; 
@Deprecated 

public static final int SENSOR_MAGNETIC_FIELD = 1 << 3; 
@Deprecated 

public static final int SENSOR_LIGHT = 1 << 4; 

@Deprecated 

public static final int SENSOR_PROXIMITY = 1 << 5; 
@Deprecated 

public static final int SENSOR_TRICORDER = 1 << 6; 
@Deprecated 

public static final int SENSOR ORIENTATION RAW = 1 << 7; 
@Deprecated 

public static final int SENSOR_ALL = 0x7F; 

@Deprecated 

public static final int SENSOR_MIN = SENSOR_ORIENTATION; 
@Deprecated 

public static final int SENSOR_MAX = ((SENSOR_ALL + 1)>>1); 


@Deprecated 

public static final int DATA_X = 0; 
@Deprecated 

public static final int DATA_Y = 1; 
@Deprecated 

public static final int DATA_Z = 2; 
@Deprecated 

public static final int RAW_DATA_INDEX = 3; 
@Deprecated 

public static final int RAW_DATA_X = 3; 
@Deprecated 

public static final int RAW_DATA_Y = 4; 
@Deprecated 

public static final int RAW DATA Z = 5; 


public static final float STANDARD. GRAVITY = 9.80665f; 


public static final float GRAVITY SUN = 275.0f; 
public static final float GRAVITY MERCURY = 3.70f, 


public static final float GRAVITY VENUS = 8.87f; 
public static final float GRAVITY EARTH = 9.80665; 
public static final float GRAVITY MOON - 1.6f; 
public static final float GRAVITY MARS = 3.71f; 
public static final float GRAVITY JUPITER = 23.12f; 
public static final float GRAVITY SATURN - 8.96f; 
public static final float GRAVITY URANUS = 8.69f; 
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public static final float GRAVITY NEPTUNE = 11.0f; 

public static final float GRAVITY PLUTO = 0.6f; 

public static final float GRAVITY DEATH STAR | = 0.000000353036145f; 
public static final float GRAVITY THE ISLAND - 4.815162342f; 


ГӨЖ ЖЕШ BJ RR REOR 

public static final float MAGNETIC_FIELD_EARTH_MAX = 60.0f; 
[** sb ЖЕШ [ор A" 

public static final float MAGNETIC FIELD EARTH MIN = 30.0f; 
IPE A SE] 

public static final float PRESSURE_STANDARD_ATMOSPHERE = 1013.25f; 
public static final float LIGHT_SUNLIGHT_MAX = 120000.0f; 
public static final float LIGHT_SUNLIGHT = 110000.0f; 

public static final float LIGHT_SHADE = 20000.0f; 

public static final float LIGHT_OVERCAST = 10000.0f; 

public static final float LIGHT_SUNRISE = 400.0f; 

public static final float LIGHT_CLOUDY = 100.0f; 

public static final float LIGHT FULLMOON = 0.25f; 

public static final float LIGHT NO MOON = 0.001f; 


/* 尽 可 能 快 地 获得 传感器 数据 */ 
public static final int SENSOR_DELAY_FASTEST = 0; 
ГЭЕ "І 
public static final int SENSOR_DELAY_GAME = 1; 
/* 适 合 于 用 户 接口 速率 */ 
public static final int SENSOR_DELAY_UI = 2; 
Г* (默认 值 ) 适合 屏幕 方向 的 变化 
public static final int SENSOR_DELAY_NORMAL = 3; 
p. 
* 返 回 的 值 ， 该 传感器 是 不 可 信和 的 ， 需 要 进行 校准 或 环境 不 允许 读数 
public static final int SENSOR_STATUS_UNRELIABLE = 0; 
p 
* 该 传感器 是 报告 的 低 精度 的 数据 ， 与 环境 的 校准 是 必要 的 
У) 
public static final int SENSOR_STATUS_ACCURACY_LOW = 1; 
p. 
* 这 种 传感器 是 精确 的 平均 频率 的 报告 数据 ， 与 环境 的 校准 可 以 提高 精确 度 
| 
public static final int SENSOR_STATUS_ACCURACY_MEDIUM = 2; 


/该 传 感 报告 准确 性 最 大 的 数据 ”/ 

public static final int SENSOR_STATUS_ACCURACY_HIGH = 3; 
public static final int AXIS_X = 1; 

public static final int AXIS_Y = 2; 

public static final int AXIS_Z = 3; 

public static final int AXIS MINUS X = AXIS X | 0x80; 

public static final int AXIS MINUS Y - AXIS Y | 0x80; 

public static final int AXIS MINUS Z = AXIS Z | 0x80; 
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(2) 定义 各 种 设备 类 型 方法 和 设备 数据 的 方法 ， 这 些 方法 非常 重要 ， 在 编写 的 应 用 程序 中 ， 可 以 
通过 AIDL 接口 远程 调用 (RPC) 的 方式 得 到 SensorManager。 这 样 通过 在 类 SensorManager 中 的 方法 ， 
可 以 得 到 底层 的 各 种 传感器 数据 。 上 述 方法 的 具体 实现 代码 如 下 : 

public int getSensors() ( 
return getLegacySensorManager().getSensors(); 


H 
public List<Sensor> getSensorList(int type) { 
/人 第 一 次 缓存 返回 列表 
List<Sensor> list; 
final List<Sensor> fullList = getFullSensorList(); 
synchronized (mSensorListByType) { 
list = mSensorListByType.get(type); 
if (list == null) { 
if (type == Sensor. TYPE_ALL) { 
list = fullList; 
) else { 
list = new ArrayList<Sensor>(); 
for (Sensor i : fullList) { 
if (i.getType() == type) 
list.add(i); 
} 
} 
list = Collections.unmodifiableList(list); 
mSensorListByType.append(type, list); 
} 
} 
return list; 
} 
public Sensor getDefaultSensor(int type) { 
List<Sensor> | = getSensorList(type); 
return LisEmpty() ? null : I.get(0); 
} 
@Deprecated 
public boolean registerListener(SensorListener listener, int sensors) { 
return registerListener(listener, sensors, SENSOR DELAY NORMAL); 
} 
@Deprecated 
public boolean registerListener(SensorListener listener, int sensors, int rate) { 
return getLegacySensorManager().registerListener(listener, sensors, rate); 
} 
@Deprecated 
public void unregisterListener(SensorListener listener) { 
unregisterListener(listener, SENSOR ALL | SENSOR ORIENTATION RAW); 
) 
@Deprecated 
public void unregisterListener(SensorListener listener, int sensors) { 
getLegacySensorManager().unregisterListener(listener, sensors); 
} 


public void unregisterListener(SensorEventListener listener, Sensor sensor) { 
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if (listener == null || sensor == null) { 
return; 
} 
unregisterListenerlmpl(listener, sensor); 
} 
public void unregisterListener(SensorEventListener listener) { 
if (listener == null) { 
return; 
} 
unregisterListenerlmpl(listener, null); 
) 
protected abstract void unregisterListenerlmpl(SensorEventListener listener, Sensor sensor); 
public boolean registerListener(SensorEventListener listener, Sensor sensor, int rate) ( 
return registerListener(listener, sensor, rate, null); 
} 
public boolean registerListener(SensorEventListener listener, Sensor sensor, int rate, 
Handler handler) { 
if (listener == null || sensor == null) { 
return false; 


} 


int delay = -1; 
switch (rate) { 
case SENSOR_DELAY_FASTEST: 
delay = 0; 
break; 
case SENSOR_DELAY_GAME: 
delay = 20000; 
break; 
case SENSOR_DELAY_UI: 
delay = 66667; 
break; 
case SENSOR_DELAY_NORMAL: 
delay = 200000; 
break; 
default: 
delay = rate; 
break; 
} 
return registerListenerlmpl(listener, sensor, delay, handler); 
} 
protected abstract boolean registerListenerlmpl(SensorEventListener listener, Sensor sensor, 
int delay, Handler handler); 


public static boolean getRotationMatrix(float[] R. float[] |, 
float[] gravity, float[] geomagnetic) { 
float Ax = gravity[0]; 
float Ay = gravity[1]; 
float Az = gravity[2]; 
final float Ex = geomagnetic[0]; 
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final float Ey = geomagnetic[1]; 
final float Ez = geomagnetic[2]; 
float Hx = Ey*Az - Ez*Ay; 
float Hy = Ez*Ax - Ex*Az; 
float Hz = Ex*Ay - Ey*Ax; 
final float normH = (float)Math.sqrt(Hx*Hx + Hy*Hy + Hz*Hz); 
if (normH < 0.1f) { 
/设备 靠近 自由 下 落 ， 或 接近 北 磁极 ， 典 型 值 是 > 100 
return false; 
} 
final float invH = 1.0f / normH; 
Hx *= invH; 
Hy *= invH; 
Hz *= invH; 
final float invA = 1.0f / (float)Math.sqrt(Ax*Ax + Ay*Ay + Az*Az); 
Ax *= invA; 
Ay *= invA; 
Az *= invA; 
final float Mx = Ay*Hz - Az*Hy; 
final float My = Az*Hx - Ax*Hz; 
final float Mz = Ax*Hy - Ay*Hx; 
if (R != null) { 
if (R.length == 9) { 
R[0] = Hx; R[1] = Hy; R[2] = Hz; 
R[3] = Мх; ҚА] = My; R[5] = Mz; 
R[6] = Ax — R[7] = Ау; R[8] = Az; 
) else if (R.length == 16) ( 
R[0] = Hx; R[1] = Hy; R[2] = Hz; R[3] 70; 
R[4] = Mx; R[5]* Му; R[6] = Mz; R7] 70; 
R[8] = Ax ҚІ9] = Ay; R[10] = Az; 
R[12] 20; ҚИЗ] = 0; R[14] = 0; R[15] = 1; 


} 
} 
if (1 != null) { 
// 通 过 投射 地 磁 向 量 到 2 (BA) 和 X (地 磁 矢 量 的 水 平分 量 ) 计算 轴 的 倾斜 基质 
final float invE = 1.0f / (float)Math.sqrt(Ex*Ex + Ey*Ey + Ez*Ez); 
final float с = (Ex*Mx + Ey*My + Ez*Mz) * invE; 
final float s = (Ex*Ax + Ey*Ay + Ez*Az) * invE; 
if (length == 9) ( 
[0] = 1; i50;  I[2]= 0; 
I[3] = 0; I[4] 1[5] = s; 
I[6] = 0; V7] =s; I[8] = с; 
} else if (I.length == 16) ( 
[0] = 1; q[1]20; 12]=0; 
14] = 0; 115] 116] = s; 
18] = 0; 19] =-s; 1[10]=с; 
1[3] = I[7] = 1[11] = 112] = 1[13] = 114] = 0; 
115] = 1; 
} 
} 


n Android 物 联网 开发 从 入 门 到 实战 


return true; 
} 
public static float getInclination(float[] 1) { 
if (llength == 9) ( 
return (float)Math.atan2(I[5], I[4]); 
) else ( 
return (float)Math.atan2(I[6], I[5]); 
J 
) 
public static boolean remapCoordinateSystem(float[] inR, int X, int Y, 
float[] outR) 
{ 
if (inR == outR) { 
final float[] temp = mTempMatrix; 
synchronized(temp) { 
if (remapCoordinateSystemlmpl(inR, X, Y, temp)) { 
final int size = outR.length; 
for (int i-0 ; i<size ; i++) 
outR[i] = templi]; 
return true; 
} 
} 
} 
return remapCoordinateSystemImpl(inR, X, Y, outR); 
) 


private static boolean remapCoordinateSystemlImpl(float[] inR, int X, int Y, 
float[] outR) 
{ 
r 
*XUf Y 定义 一 个 旋转 矩阵 'R' : 


* 


(X: 


* 1)2((Х&0х80)?-1:1):0  (X==2)2((X&0X80)?-1:1):0  (X==3)?((X80x80)?-1:1):0 
* (Y==1)?((Y&0x80)?-1:1):0  (Y==2)2((Y&0x80)2-1:1):0  (Y==3)?((X&0x80)?-1:1):0 
[0] ^ [1] 

* 其 中 第 三 行 是 前 两 行 的 向 量 积 


sli 


final int length = outR.length; 

if (inR.length != length) 
return false; —//invalid parameter 

if ((X & 0х7С)!=0 || (Y & 0х7С)!=0) 
return false; —//invalid parameter 

if ((X & 0х3)==0) || (Y & 0x3)==0)) 
return false; //по axis specified 

if ((X & 0х3) == (Y & 0х3)) 
return false; //ѕате axis specified 


(m, 
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intZ=X*Y; 


final int x = (X & 0x3)-1; 
final int y = (Y & 0x3)-1; 
final int z = (Z & 0х3)-1; 


final int axis y = (2+1)%3; 

final int axis 2 = (2+2)%3; 

if ((x^axis y)|(y^axis z)) != 0) 
Z ^= 0x80; 


final boolean sx = (X>=0x80); 
final boolean sy = (Y>=0x80); 
final boolean sz = (Z>=0x80); 


final int rowLength = ((length==16)?4:3); 
for (int j=0 ; j<3 ; j++) { 
final int offset = j*rowLength; 
for (int i=0 ; i<3 ; i++) { 
if (x==i)  outR[offset+i] = sx ? -inR[offset+0] : inR[offset+0]; 
if (y==i)  outR[offset+i] = sy ? -inR[offset+1] : inR[offset+1]; 
if (z==i)  outR[offset+i] = sz ? -inR[offset+2] : inR[offset+2]; 


} 


} 

if (length == 16) { 
outR[3] = outR[7] = outR[11] = outR[12] = outR[13] = outR[14] = 0; 
outR[15] = 1; 

} 

return true; 


} 
public static float[] getOrientation(float[] R, float values[]) { 


if (R.length == 9) ( 
values[0] = (float)Math.atan2(R[1], R[4]); 
values[1] = (float)Math.asin(-R[7]); 
values[2] = (float)Math.atan2(-R[6], R[8]); 
)else( 
values[0] = (float)Math.atan2(R[1], R[5]); 
values[1] = (float)Math.asin(-R[9]); 
values[2] = (float)Math.atan2(-R[8], R[10]); 
} 
return values; 
} 
public static float getAltitude(float pO, float p) { 
final float coef = 1.0f / 5.255f; 
return 44330.0f * (1.0f - (float)Math.pow(p/p0, coef)); 
} 


public static void getAngleChange( float[] angleChange, float] R, float[] prevR) { 
float rd1=0,rd4=0, rd6=0,rd7=0, rd8=0; 
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float ri0=0,ri1=0,ri2=0,ri3=0,ri4=0,ri§=0,ri6=0,ri7=0,ri8=0; 
float pri0=0, pri1=0, pri2=0, pri3=0, ргі4=0, ргі5=0, pri6=0, pri7=0, pri8=0; 


if(R.length == 9) { 
ri0 = R[O]; 
ri1 = R[1]; 
ri2 = R[2]; 
ri3 = R[3]; 
ri4 = КИ]; 
ri5 = R[5]; 
ri6 = R[6]; 
ri7 = R[7]; 
ri8 = R[8]; 

} else if(R.length == 16) ( 
ri0 = R[O]; 
rit = Кү]; 
ri2 = R[2]; 
ri3 = R[4]; 
ri4 = R[5]; 
rib = R[6]; 
ri6 = R[8]; 
ri7 = R[9]; 
ri8 = R[10]; 

} 


if(prevR.length == 9) { 
prio = prevR[0]; 
pri1 = prevR[1]; 
pri2 = prevR[2]; 
pri3 = prevR[3]; 
pri4 = prevR[4]; 
pri5 = prevR[5]; 
pri6 = prevR[6]; 
pri7 = prevR[7]; 
pri8 = prevR[8]; 

} else if(prevR.length == 16) { 
prio = prevR[0]; 
pri1 = prevR[1]; 
pri2 = prevR[2]; 
pri3 = prevR[4]; 
pri4 = prevR[5]; 
pri5 = prevR[6]; 
pri6 = prevR[8]; 
pri? = prevR[9]; 
pri8 = prevR[10]; 

} 


/计算 出 我 们 需要 的 旋转 差 矩 阵 的 部 分 
IIrd[illi] = pri[0]i] * ri[0][i] + pri[11[i] * ri[11[i] + pri[21i] * [2]; 
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rd1 = pri0 * ri1 + pri3 * ri4 + pri6 * ri7; /Ird[0][1] 
rd4 = pri1 * гії + pri4 * ri4 + pri7 * ri7; //rd[1][1] 
rd6 = pri2 * ri0 + pri5 * ri3 + pri8 * ri6; //rd[2][0] 
rd7 = pri2 * rit + pri5 * ri4 + pri8 * ri7; /Ird[2][1] 
rd8 = pri2 * ri2 + pri5 * ri5 + pri8 * ri8; //rd[2][2] 


angleChange[0] = (float)Math.atan2(rd1, rd4); 
angleChange[1] = (float)Math.asin(-rd7); 
angleChange[2] = (float)Math.atan2(-rd6, rd8); 
} 
public static void getRotationMatrixFromVector(float[] К, float[] rotationVector) { 


float q0; 

float q1 = rotationVector[0]; 
float q2 = rotationVector[1]; 
float q3 = rotationVector[2]; 


if (rotationVector.length == 4) ( 

q0 = rotationVector[3]; 
) else { 

q0 = 1 - q1*q1 - q2*q2 - q3*q3; 

q0 = (q0 > 0) ? (float)Math.sqrt(q0) : 0; 
} 


float sq_q1 = 2 * q1 * q1; 
float sq_q2 = 2 * q2 * q2; 
float sq_q3 = 2 * q3 * q3; 
float q1_q2 = 2 * q1 * q2; 
float q3_q0 = 2 * q3 * q0; 
float q1_q3 = 2 * q1 * q3; 
float q2_q0 = 2 * q2 * q0; 
float q2_q3 = 2 * q2 * q3; 
float q1_q0 = 2 * q1 * q0; 


if(R.length == 9) { 
R[0] = 1 - sq_q2 - sq_q3; 
R[1] = q1 q2- q3_q0; 
R[2] = q1_q3 + q2 q0; 


R[3] = q1_q2 + 43 90; 
КИА] = 1 - sq_q1 - sq_q3; 
R[5] = 42 43 - q1 q0; 


R[6] = q1_q3 - 92_90; 
R[7] = q2 q3 + q1 q0; 
R[8] = 1 -sq q1-sq q2; 
) else if (R.length == 16) { 
R[0] = 1 - sq_q2 - sq_q3; 
R[1] = q1_q2 - q3_q0; 
R[2] = q1_q3 + q2_q0; 
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) 


R[3] = 0.0f; 


R[4] = q1 q2 + q3 q0; 
R[5] = 1 - sq_q1 - sq_q3; 
R[6] = q2_q3 - q1_q0; 
Б[7] = 0.0f; 


R[8] = q1_q3 - q2_q0; 
R[9] = q2. q3 + q1_q0; 
R[10] = 1 - sq q1 - sq 42; 
R[11] = 0.0f; 


R[12] = R[13] = R[14] = 0.07, 
R[15] = 1.01; 
} 


} 
public static void getQuaternionFromVector(float[] Q, float[] rv) { 
if (rv.length == 4) { 
О[0] = rv[3]; 
) else { 
О[0] = 1 - rv[0]*rv[0] - rv[1]*rv[1] - rv[2]*rv[2]; 
О[0] = (О[0] > 0) ? (float)Math.sqrt(Q[0]) : 0; 
} 
Q[1] = rv[0]; 
О[2] = rv[1]; 
Q[3] = rv[2]; 
} 
public boolean requestTriggerSensor(TriggerEventListener listener, Sensor sensor) { 
return requestTriggerSensorlmpl(listener, sensor); 
} 


protected abstract boolean requestTriggerSensorlmpl(TriggerEventListener listener, 
Sensor sensor); 
public boolean cancelTriggerSensor(TriggerEventListener listener, Sensor sensor) ( 
return cancelTriggerSensorlmpl(listener, sensor, true); 
protected abstract boolean cancelTriggerSensorlmpl(TriggerEventListener listener, 
Sensor sensor, boolean disable); 
private LegacySensorManager getLegacySensorManager() ( 
synchronized (mSensorListByType) ( 
if (mLegacySensorManager == null) ( 
Log.i(TAG, "This application is using deprecated SensorManager API which will " 
* "be removed someday. Please consider switching to the new API."); 
mLegacySensorManager = new LegacySensorManager(this); 
n 


return mLegacySensorManager; 


} 


上 述 方法 的 功能 非常 重要 ， 其 实 就 是 我 们 在 开发 传感器 应 用 程序 时 用 到 的 АРІ 接口 。 有 关上 述 方 
法 的 具体 说 明 , 读者 可 以 查阅 官网 SDK API 中 对 于 类 android.hardware.SensorManager 的 具体 说 明 ， 如 
图 10-3 所 示 。 
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10-3 Android SDK API 中 对 android.hardware.SensorManager 的 具体 说 明 


Sensor Type 
‘TYPE_ACCELEROMETER Hardware 
TYPE AMBIENT TENPERATURE Hardware 
TYPE GRAVITY Software 
or 
Hardware 
TYPE GTROSCOPE Hardware 
TYPE. LIGHT Hardware 
TYPE LINEAR ACCELERATION ^ Software 
or 
Hardware 


вое Anod вян ИП 


Descr 


tion 


Measures the acceleration force in m/s? that 
is applied to a device on all three physical 
axes (x. y, and z), including the force of 
gravity. 


Measures the ambient room temperature in 
degrees Celsius (*C). See note below. 


Measures the force of gravity in m/s? that is 
applied to a device on all three physical axes 
@у.т). 


Measures a device's rate of rotation in rad/s 
around each of the three physical axes (x, y, 
and). 


Measures the ambient light level 
(illumination) in bx. 


Measures the acceleration force in m/s? that 
is applied to а device on all three physical 
axes (x, y, and z), excluding the force of 
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Фин 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 10 EUNT 层 详解 .avi 
在 Android 系 统 中 , 传感器 系统 的 JNI 部 分 的 代码 路 径 是 frameworks/base/core/jni/android hardware _ 


SensorManager.cpp 。 


Common Uses 
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ес). 


Monitoring air 
temperatures. 


Motion 
detection 
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screen 
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在 此 文件 中 提供 了 对 类 android.hardware.Sensor.Manage 的 本 地 支持 。 上 层 和 ЛП 层 的 调用 关系 如 


图 10-4 所 示 。 


104 上 层 和 JNI 层 的 调用 关系 
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在 图 10-4 所 示 的 调用 关系 中 涉及 了 如 下 所 示 的 АРІ 接口 方法 。 

nativeClassInit(): 在 JNI 层 得 到 android.hardware.Sensor 的 INI 环境 指针 。 

sensors module init(): 通过 INI 调用 本 地 框架 ， 得 到 SensorService，SensorService 初始 化 控制 
流 各 功能 。 

new Sensor): 建立 一 个 Sensor 对 象 ， 具 体 可 查阅 官网 API android.hardware.Sensor。 

sensors module get next sensor: 上 层 得 到 设备 支持 的 所 有 Sensor， 并 放 入 SensorList 链表 。 

new SensorThread(): 创建 Sensor 线程 ， 当 应 用 程序 registerListener() 注 册 监 听 器 时 开启 线程 
rn0， 注 意 当 没有 数据 变化 时 线程 会 阻塞 。 


M 


10.4.1 


实现 本 地 函数 


文件 android_hardware_SensorManager.cpp 的 功能 是 实现 文件 SensorManager.java 中 的 native( 本 地 ) 
函数 , 主要 是 通过 调用 文件 SenrsorManagercpp 和 SensorEventQueue.cpp 中 的 相关 类 来 完成 相关 工作 的 。 
文件 android_hardware_SensorManager.cpp 的 具体 实现 代码 如 下 : 


static struct { 


jclass clazz; 
jmethodID dispatchSensorEvent; 
} gBaseEventQueueClasslnfo; 


namespace android { 

struct SensorOffsets 

{ 
jfieldID name; 
jfieldlD — vendor; 
jfieldID — version; 
jfieldID handle; 
jfieldID type; 
jfieldID range; 
jfieldID resolution; 
jfieldID power; 
jfieldID minDelay; 

} gSensorOffsets; 

n 


“下 面 的 方法 是 不 是 线程 安全 的 和 不 打算 用 的 


di 


static void 
nativeClassInit (JNIEnv *_env, jclass this) 


{ 


人 的 


jclass sensorClass = _env->FindClass("android/hardware/Sensor"); 

SensorOffsets& sensorOffsets = gSensorOffsets; 

sensorOffsets.name = _env->GetFieldID(sensorClass,"mName", "Ljava/lang/String;"); 
sensorOffsets vendor = _env->GetFieldID(sensorClass,"mVendor", "Ljava/lang/String;"); 
sensorOffsets.version = env-»GetFieldID(sensorClass,"mVersion", "I"); 


} 
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sensorOffsets.handle = _env->GetFieldID(sensorClass,"mHandle", "!"); 
sensorOffsets.type = _env->GetFieldID(sensorClass,"mType", "|"); 
sensorOffsets.range = _env->GetFieldID(sensorClass,"mMaxRange", "F"); 
sensorOffsets.resolution = _env->GetFieldID(sensorClass,"mResolution","F"); 
sensorOffsets.power = _env->GetFieldID(sensorClass,"mPower", "F"); 
sensorOffsets.minDelay = _env->GetFieldID(sensorClass,"mMinDelay", "I"); 


static jint 
nativeGetNextSensor(JNIEnv “env, jclass clazz, jobject sensor, jint next) 


{ 


} 


SensorManager& mgr(SensorManager::getInstance()); 


Sensor const* const* sensorList; 
size_t count = mgr.getSensorList(&sensorList); 
if (size_t(next) >= count) 

return -1; 


Sensor const* const list = sensorList[next]; 

const SensorOffsets& sensorOffsets(gSensorOffsets); 

jstring name = env->NewStringUTF (list->getName().string()); 

jstring vendor = env->NewStringUTF(list->getVendor().string()); 
env->SetObjectField(sensor, sensorOffsets.name, name); 
env->SetObjectField(sensor, sensorOffsets.vendor, vendor); 
env->SetintField(sensor, sensorOffsets. version, list->getVersion()); 
env->SetintField(sensor, sensorOffsets.handle, list->getHandle()); 
env->SetintField(sensor, sensorOffsets.type, list->getType()); 
env->SetFloatField(sensor, sensorOffsets.range, list->getMaxValue()); 
env->SetFloatField(sensor, sensorOffsets.resolution, list->getResolution()); 
env->SetFloatField(sensor, sensorOffsets.power, list->getPowerUsage()); 
env->SetintField(sensor, sensorOffsets.minDelay, list->getMinDelay()); 


next++; 
return size_t(next) < count ? next : 0; 


J 


class Receiver : public LooperCallback { 


sp<SensorEventQueue> mSensorQueue; 
sp<MessageQueue> mMessageQueue; 
jobject mReceiverObject; 

jfloatArray mScratch; 


public: 


Receiver(const sp<SensorEventQueue>& sensorQueue, 
const sp<MessageQueue>& messageQueue, 
jobject receiverObject, jfloatArray scratch) { 

JNIEnv* env = AndroidRuntime::getJNIEnv(); 
mSensorQueue = sensorQueue; 

mMessageQueue = messageQueue; 

mReceiverObject = env->NewGlobalRef(receiverObject); 
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mScratch = (jfloatArray)env->NewGlobalRef(scratch); 


} 

~Receiver() { 
JNIEnv* env = AndroidRuntime::getJNIEnv(); 
env->DeleteGlobalRef(mReceiverObject); 
env->DeleteGlobalRef(mScratch); 

} 


sp<SensorEventQueue> getSensorEventQueue() const { 
return mSensorQueue; 


} 


void destroy() { 
mMessageQueue->getLooper()->removeFd( mSensorQueue->getFd() ); 


} 


private: 
virtual void onFirstRef() { 
LooperCallback::onFirstRef(); 
mMessageQueue->getLooper()->addFd(mSensorQueue->getFd(), 0, 
ALOOPER_EVENT_INPUT, this, mSensorQueue.get()); 
} 


virtual int handleEvent(int fd, int events, void* data) { 
JNIEnv* env = AndroidRuntime::getJNIEnv(); 
sp<SensorEventQueue> q = reinterpret_cast<SensorEventQueue *>(data); 
ssize tn; 
ASensorEvent buffer[16]; 
while ((n = q->read(buffer, 16)) > 0) ( 
for (int i=0 ; i<n ; i++) ( 


env-»SetFloatArrayRegion(mScratch, 0, 16, buffer[i].data); 


env-»CallVoidMethod(mReceiverObject, 
gBaseEventQueueClassinfo.dispatchSensorEvent, 
buffer[i].sensor, 
mScratch, 
buffer[i].vector.status, 
buffer[i].timestamp); 


if (env->ExceptionCheck()) { 
ALOGE("Exception dispatching input event."); 


return 1; 
) 
у 
} 
if (п<0 && п != -EAGAIN) { 
} 
return 1; 
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static jint nativelnitSensorEventQueue(JNIEnv “env, jclass clazz, jobject eventQ, jobject msgQ, jfloatArray 
scratch) { 

SensorManager& mgr(SensorManager::getInstance()); 

sp<SensorEventQueue> queue(mgr.createEventQueue()); 


sp<MessageQueue> messageQueue = android_os_MessageQueue_getMessageQueue(env, msgQ); 
if (messageQueue == NULL) { 

jniThrowRuntimeException(env, "MessageQueue is not initialized."); 

return 0; 


} 


sp<Receiver> receiver = new Receiver(queue, messageQueue, eventQ, scratch); 
receiver-»incStrong((void*)nativelnitSensorEventQueue); 
return jint(receiver.get()); 


) 


static jint nativeEnableSensor(JNIEnv “env, jclass clazz, jint eventQ, jint handle, jint us) ( 
sp<Receiver> receiver(reinterpret cast«Receiver *>(eventQ)); 
return receiver->getSensorEventQueue()->enableSensor(handle, us); 


} 


static jint nativeDisableSensor(JNIEnv “env, jclass clazz, jint eventQ, jint handle) { 
sp<Receiver> receiver(reinterpret_cast<Receiver *>(eventQ)); 
return receiver->getSensorEventQueue()->disableSensor(handle); 


} 


static void nativeDestroySensorEventQueue(JNIEnv “env, jclass clazz, jint eventQ, jint handle) { 
sp<Receiver> receiver(reinterpret_cast<Receiver *>(eventQ)); 
receiver->destroy(); 
receiver-»decStrong((void*)nativelnitSensorEventQueue); 


static JNINativeMethod gSystemSensorManagerMethods[] = ( 
('nativeClasslnit", 
"Qv", 
(void*)nativeClasslnit }, 


{"nativeGetNextSensor", 
"(Landroid/hardware/Sensor;!)I", 
(void*)nativeGetNextSensor }, 


ү 


static JNINativeMethod gBaseEventQueueMethods]] = { 
('nativelnitBaseEventQueue", 


"(Landroid/hardware/SystemSensorManager$BaseEventQueue;Landroid/os/MessageQueue;|F)I", 
(void*)nativelnitSensorEventQueue }, 


89) 


E 
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{"nativeEnableSensor", 
"ayi", 
(void*)nativeEnableSensor }, 


{"nativeDisableSensor", 
"(и)", 
(void*)nativeDisableSensor }, 


{"nativeDestroySensorEventQueue", 
фуу", 
(void*)nativeDestroySensorEventQueue }, 


E 
Ë 
using namespace android; 


#define FIND_CLASS(var, className) \ 
var = env->FindClass(className); V 
LOG_FATAL_IF(! var, "Unable to find class " className); \ 
var = jclass(env->NewGlobalRef(var)); 


#define GET_METHOD_ID(var, clazz, methodName, methodDescriptor) \ 
var = env->GetMethodID(clazz, methodName, methodDescriptor); Y 
LOG_FATAL_IF(! var, "Unable to find method " methodName); 


int register android hardware SensorManager(JNIEnv *env) 


{ 
jniRegisterNativeMethods(env, "android/hardware/SystemSensorManager", 
gSystemSensorManagerMethods, NELEM(gSystemSensorManagerMethods)); 


jniRegisterNativeMethods(env, "android/hardware/SystemSensorManager$BaseEventQueue", 
gBaseEventQueueMethods, NELEM(gBaseEventQueueMethods)); 


FIND CLASS(gBaseEventQueueClasslnfo.clazz, 
"android/hardware/SystemSensorManager$BaseEventQueue"); 


GET METHOD ID(gBaseEventQueueClasslnfo.dispatchSensorEvent, 
gBaseEventQueueClassinfo.clazz, 
"dispatchSensorEvent", "(I[FlJ)V"); 


return 0; 


} 
10.4.2 “处理 客户 端 数据 


文件 frameworks/native/libs/gui/SensorManager.cpp 提供 了 对 传感器 数据 部 分 的 操作 ,实现 了 sensor. 
data XXXO0 格 式 的 函数 。 另 外 在 Native 层 的 客户 端 , 文件 SensorManager.cpp 还 负责 与 服务 端 SensorService.cpp 


® 
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之 间 的 通信 工作 。 文 件 SensorManager.cpp 的 具体 实现 代码 如 下 : 


II 


namespace android { 


II 


ANDROID_SINGLETON_STATIC_INSTANCE(SensorManager) 


SensorManager::SensorManager() 


{ 
} 


: mSensorList(0) 


assertStateLocked(); 


SensorManager::~SensorManager() 


{ 
} 


free(mSensorList); 


void SensorManager::sensorManagerDied() 


{ 


} 


Mutex::Autolock _I(mLock); 
mSensorServer.clear(); 
free(mSensorList); 
mSensorList = NULL; 
mSensors.clear(); 


status_t SensorManager::assertStateLocked() const { 


if (mSensorServer == NULL) { 
const String16 name("sensorservice"); 
for (int i=0 ; i<4 ; i++) { 
status_t err = getService(name, &mSensorServer); 
if (err == NAME_NOT_FOUND) { 
usleep(250000); 
continue; 
} 
if (err != NO ERROR)( 
return err; 
} 
break; 
} 


class DeathObserver : public IBinder::DeathRecipient { 
SensorManager& mSensorManger; 
virtual void binderDied(const wp<IBinder>& who) { 
ALOGW("sensorservice died [%p]", who.unsafe_get()); 
mSensorManger.sensorManagerDied(); 
} 
public: 
DeathObserver(SensorManager& mgr) : mSensorManger(mgr) { } 
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mDeathObserver = new DeathObserver(*const_cast<SensorManager *>(this)); 
mSensorServer->asBinder()->linkToDeath(mDeathObserver); 


mSensors = mSensorServer-»getSensorL ist(); 
Size t count - mSensors.size(); 
mSensorList = (Sensor const**)malloc(count * sizeof(Sensor*)); 
for (size ti-0 ; i«count ; i++) { 
mSensorList[i] = mSensors.array() + i; 
) 
) 


return NO ERROR; 
) 
ssize t SensorManager::getSensorList(Sensor const* const** list) const 
{ 
Mutex::Autolock _I(mLock); 
status t err = assertStateLocked(); 
if (err < 0) { 
return ssize_t(err); 
} 
*list = mSensorList; 
return mSensors.size(); 


} 
Sensor const* SensorManager::getDefaultSensor(int type) 


Mutex::Autolock  l(mLock); 
if (assertStateLocked() == NO ERROR) ( 
for (size_t i=0 ; i<mSensors.size() ; i++) ( 
if (mSensorList[i]->getType() == type) 
return mSensorList[i]; 
} 
} 
return NULL; 
} 


sp<SensorEventQueue> SensorManager::createEventQueue() 


{ 


sp<SensorEventQueue> queue; 


Mutex::Autolock _I(mLock); 
while (assertStateLocked() == NO_ERROR) { 
sp«ISensorEventConnection» connection = 
mSensorServer->createSensorEventConnection(); 
if (connection == NULL) { 
ALOGE("createEventQueue: connection is NULL. SensorService died."); 
continue; 


} 


queue = new SensorEventQueue(connection); 
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} 


Il 
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break; 


} 


return queue; 


10.4.3 ”处 理 服务 端 数据 


文件 frameworks/native/services/sensorservice/SensorService.cpp 能 够 实现 Sensor 真正 的 后 台 服 务 ， 
是 服务 端的 数据 处 理 中 心 。 在 Android 的 传感器 系统 中 ,SensorService 作 为 一 个 轻 量 级 的 System Service, 
在 SystemServer 内 运行 , 在 system_init<system_init.cpp> 中 调用 了 SensorService::instantiate()。 具 体 来 说 ， 
SensorService 的 主要 功能 如 下 : 


(1) 通过 SensorService::instantiate 创建 实例 对 象 ， 并 增加 到 ServiceManager 中 ， 然 后 创建 并 启动 


线程 ， 并 执行 threadLoop。 


Рай. 


(2) threadLoop 从 sensor 驱动 获取 原始 数据 ， 然 后 通过 SensorEventConnection 把 事件 发 送 给 客 


(3) BnSensorServer 的 成 员 函 数 负责 让 客户 端 获 取 sensor 列表 和 创建 SensorEventConnection 。 


文件 SensorService.cpp 的 具体 实现 代码 如 下 : 


namespace android { 


const char* SensorService:: WAKE_LOCK_NAME = "SensorService"; 


SensorService::SensorService() 


{ 
} 


: minitCheck(NO INIT) 


void SensorService::onFirstRef() 


{ 


ALOGD("nuSensorService starting..."); 
SensorDevice& dev(SensorDevice::getinstance()); 


if (dev.initCheck() == NO_ERROR) { 
sensor t const' list; 
ssize t count = dev.getSensorList(&list); 
if (count > 0) ( 
Ssize t orientationIndex = -1; 
bool hasGyro - false; 
uint32 t virtualSensorsNeeds = 
(1««SENSOR TYPE GRAVITY) | 
(1««SENSOR TYPE LINEAR, ACCELERATION) | 
(1««SENSOR TYPE ROTATION VECTOR); 


mLastEventSeen.setCapacity(count); 
for (ssize t i-0 ; i<count ; i++) { 
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registerSensor( new HardwareSensor(list{i]) ); 
switch (list[i] type) { 
case SENSOR TYPE ORIENTATION: 
orientationIndex - i; 
break; 
case SENSOR TYPE GYROSCOPE: 
hasGyro - true; 
break; 
case SENSOR TYPE GRAVITY: 
case SENSOR TYPE LINEAR ACCELERATION: 
case SENSOR TYPE ROTATION VECTOR: 
virtualSensorsNeeds &- ~(1<<list[i].type); 
break; 


} 


// 它 是 安全 的 ， 在 这 里 实例 化 SensorFusion TR 
// 如 果 被 实例 化 后 ，H/W 传感器 已 注册 
const SensorFusion& fusion(SensorFusion::getlnstance()); 


if (hasGyro) ( 
/| 总 是 实例 化 Android 的 虚拟 传感器 。 因 为 它们 是 实例 化 落后 于 HAL 的 传感器 ， 它 们 不 会 干扰 
应 用 程序 ， 除 非 它们 看 起 来 特别 像 它们 的 名 字 


registerVirtualSensor( new RotationVectorSensor() ); 
registerVirtualSensor( new GravitySensor(list, count) ); 
registerVirtualSensor( new LinearAccelerationSensor(list, count) ); 


// 这 是 选项 
registerVirtualSensor( new OrientationSensor() ); 
registerVirtualSensor( new CorrectedGyroSensor(list, count) ); 


} 


mUserSensorList = mSensorList; 


if (hasGyro) { 
registerVirtualSensor( new GyroDriftSensor() ); 


} 


if (hasGyro && 
(virtualSensorsNeeds & (1<<SENSOR_TYPE_ROTATION_VECTOR))) { 
if (orientationIndex >= 0) { 
mUserSensorList.removeltemsAt(orientationIndex); 
И 
} 


ТААЗ BST Be 
for (size_t i-0 ; i<mSensorList.size() ; i++) { 
switch (mSensorList[i].getType()) { 
case SENSOR_TYPE_GRAVITY: 
case SENSOR_TYPE_LINEAR_ACCELERATION: 
case SENSOR_TYPE_ROTATION_VECTOR: 
if (strstrmSensorList[i].getVendor().string(), "Google")) { 
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mUserSensorListDebug.add(mSensorList[i]); 
J 


break; 

default: 
mUserSensorListDebug.add(mSensorList[i]); 
break; 


} 


run("SensorService", PRIORITY_URGENT_DISPLAY); 
minitCheck = NO ERROR; 


} 
} 
} 
void SensorService::registerSensor(Sensorinterface* s) 
{ 
sensors_event_t event; 
memset(&event, 0, sizeof(event)); 
const Sensor sensor(s->getSensor()); 
/添加 到 传感器 列表 〈 返 回 给 客户 端 ) 
mSensorList.add(sensor); 
// 加 入 到 我 们 的 手柄 -> Sensorinterface 映射 
mSensorMap.add(sensor.getHandle(), s); 
/创建 mLastEventSeen 数组 中 的 一 个 条 目 
mLastEventSeen.add(sensor.getHandle(), event); 
} 
void SensorService::registerVirtualSensor(Sensorlnterface* s) 
{ 
registerSensor(s); 
mVirtualSensorList.add(s ); 
} 
SensorService::~SensorService() 
{ 
for (size t i-0 ; i<mSensorMap.size() ; i++) 
delete mSensorMap.valueAt(i); 
) 


static const String16 sDump("android.permission.DUMP"); 


status_t SensorService::dump(int fd, const Vector<String16>& args) 
{ 
const size_t SIZE = 1024; 
char buffer[SIZE]; 
String8 result; 
if (!PermissionCache::checkCallingPermission(sDump)) { 
snprintf(buffer, SIZE, "Permission Denial: " 
“can't dump SurfaceFlinger from pid=%d, uid=%d\n", 
IPCThreadState::self()->getCallingPid(), 
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IPCThreadState::self()->getCallingUid()); 
result.append(buffer); 
else { 
Mutex::Autolock _I(mLock); 
snprintf(buffer, SIZE, "Sensor List:\n"); 
result.append(buffer); 
for (size_t i=0 ; i<mSensorList.size() ; i++) { 
const Sensor& s(mSensorList[i]); 
const sensors event t& e(mLastEventSeen.valueFor(s.getHandle())); 
snprintf(buffer, SIZE, 
"96-48s| %-325 | 0х%08х | maxRate=%7.2fHz |" 
“last=<%5.1f,%5.1f,%5.1f>\n", 
s.getName().string(), 
s.getVendor().string(), 
s.getHandle(), 
s.getMinDelay() ? (1000000.0f / s.getMinDelay()) : 0.0f, 
e.data[0], e.data[1], e.data[2]); 
result.append(buffer); 
} 
SensorFusion::getInstance().dump(result, buffer, SIZE); 
SensorDevice::getinstance().dump(result, buffer, SIZE); 


snprintf(buffer, SIZE, "%d active connections\n", 
mActiveConnections.size()); 
result.append(buffer); 
snprintf(buffer, SIZE, "Active sensors:\n"); 
result.append(buffer); 
for (size_t i=0 ; i<mActiveSensors.size() ; i++) { 
int handle = mActiveSensors.keyAt(i); 
snprintf(buffer, SIZE, "%5 (handle=0x%08x, connections=%d)\n", 
getSensorName(handle).string(), 
handle, 
mActiveSensors.valueAt(i)->getNumConnections()); 
result.append(buffer); 
} 


write(fd, result.string(), result.size()); 
return NO_ERROR; 
} 


void SensorService::cleanupAutoDisabledSensor(const sp<SensorEventConnection>& connection, 
sensors_event_t const* buffer, const int count) { 
Sensorlnterface* sensor; 
status t err = NO ERROR; 
for (int i=0 ; i<count ; i++) ( 
int handle = buffer[i].sensor; 
if (getSensorType(handle) == SENSOR TYPE SIGNIFICANT. MOTION) { 
if (connection->hasSensor(handle)) { 
sensor = mSensorMap.valueFor(handle); 
err = sensor ?sensor->resetStateWithoutActuatingHardware(connection.get(), handle) 
: status {ВАО VALUE); 
if (err = NO ERROR) { 


(ne, 
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ALOGE("Sensor Inteface: Resetting state failed with err: %d", err); 
} 


cleanupWithoutDisable(connection, handle); 


} 


bool SensorService::threadLoop() 


£ 
ALOGD("nuSensorService thread starting..."); 


const size_t numEventMax = 16; 

const size t minBufferSize = numEventMax + numEventMax * mVirtualSensorList.size(); 
sensors event t buffer[minBufferSize]; 

sensors event t scratch[minBufferSize]; 

SensorDevice& device(SensorDevice::getInstance()); 

const size t vcount = mVirtualSensorList.size(); 


Ssize t count; 
bool wakeLockAcquired = false; 
const int halVersion = device.getHalDeviceVersion(); 


do( 

count = device.poll(buffer, numEventMax); 

if (count<0) { 
ALOGE("sensor poll failed (%s)", strerror(-count)); 
break; 

} 

ITODO(): 添加 一 个 标志 ， 用 该 传感器 的 定义 来 表示 

// 在 这 里 可 以 唤醒 AP 传感器 


for (int i = 0; i < count; i++) { 
if (getSensorType(buffer[i].sensor) == SENSOR_TYPE_SIGNIFICANT_MOTION) { 
acquire_wake_lock(PARTIAL_WAKE_LOCK, WAKE LOCK NAME); 
wakeLockAcquired 7 true; 
break; 


} 


recordLastValue(buffer, count); 


/处 理 虚 拟 传感器 
if (count && vcount) { 
sensors_event_t const * const event = buffer; 
const DefaultKeyedVector«int, Sensorinterface*> virtualSensors( 
getActiveVirtualSensors()); 
const size t activeVirtualSensorCount - virtualSensors.size(); 
if (activeVirtualSensorCount) { 
size {К = 0; 
SensorFusion& fusion(SensorFusion::getlnstance()); 
if (fusion.isEnabled()) ( 
for (size_t i=0 ; i«size t(count) ; i++) ( 
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fusion.process(event[i]); 
} 
} 
for (size_t i=0 ; i<size_t(count) && k«minBufferSize ; i++) { 
for (size_t ј=0 ; j<activeVirtualSensorCount ; j++) { 
if (count + k >= minBufferSize) { 
ALOGE("buffer too small to hold all events: " 
"count=%u, k=%u, size=%u", 
count, k, minBufferSize); 
break; 
} 
sensors_event_t out; 
Sensorlnterface* si = virtualSensors.valueAt(j); 
if (si->process(&out, event[i])) { 
buffer[count + k] = out; 
k++; 


if (k) { 
/记录 最 近 合成 值 
recordLastValue(&buffer[count], К); 
count += К; 
/| 缓冲 器 由 时 间 稚 排序 
sortEventBuffer(buffer, count); 


} 


// 处 理 的 RotationVector 传感器 向 后 兼容 
if (halVersion < SENSORS DEVICE API VERSION 1 0)( 
for (inti = 0; i < count; i++) ( 
if (getSensorType(buffer[i].sensor) == SENSOR TYPE ROTATION VECTOR) ( 
buffer[i].data[4] = -1; 
) 


} 


/发 送 我 们 的 活动 给 客户 
const SortedVector< wp<SensorEventConnection> > activeConnections( 
getActiveConnections()); 
size t numConnections = activeConnections.size(); 
for (size t i-0 ; i<numConnections ; i++) { 
sp<SensorEventConnection> connection( 
activeConnections[i].promote()); 
if (connection != 0) ( 
connection->sendEvents(buffer, count, scratch); 
cleanupAutoDisabledSensor(connection, buffer, count); 


} 
// 我 们 已 经 读 取 的 数据 ， 上 层 需 要 控制 wakelock 
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if (wakeLockAcquired) release wake lock(WAKE LOCK NAME); 
} while (count >= 0 || Thread::exitPending()); 


ALOGW ("Exiting SensorService::threadLoop => aborting..."); 
abort(); 
return false; 


} 


void SensorService::recordLastValue( 
sensors event t const * buffer, size t count) 


{ 
Mutex::Autolock l(mLock); 
/| 为 每 个 传感器 记录 最 近 的 事件 
int32 t prev = buffer[0].sensor; 
for (size_t i=1 ; i«count ; i++) { 
// 这 个 缓冲 区 的 最 后 一 个 事件 记录 每 个 传感器 类 型 
int32_t curr = buffer[i].sensor; 
if (curr != prev) { 
mLastEventSeen.editValueFor(prev) = buffer[i-1]; 
prev = сит; 
} 
} 
mLastEventSeen.editValueFor(prev) = buffer[count-1]; 
} 
void SensorService::sortEventBuffer(sensors_event_t* buffer, size_t count) 
{ 
struct compar { 
static int cmp(void const* Ihs, void const* rhs) { 
sensors event t const* | = static_cast<sensors_event_t const*>(Ihs); 
sensors event t const* r = static cast«sensors event t const*>(rhs); 
return |->timestamp - r->timestamp; 
} 
y 
qsort(buffer, count, sizeof(sensors_event_t), compar::cmp); 
) 


SortedVector< wp<SensorService::SensorEventConnection> > 
SensorService::getActiveConnections() const 
{ 

Mutex::Autolock _I(mLock); 

return mActiveConnections; 


} 


DefaultKeyedVector«int, Sensorinterface*> 
SensorService::getActiveVirtualSensors() const 


{ 
Mutex::Autolock l(mLock); 
return mActiveVirtualSensors; 
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String8 SensorService::getSensorName(int handle) const { 

Size t count - mUserSensorList.size(); 
for (size t і=0 ; i<count ; i++) ( 

const Sensor& sensor(mUserSensorList[i]); 

if (sensor.getHandle() == handle) { 

return sensor.getName(); 

} 

} 


String8 result("unknown"); 
return result; 


} 


int SensorService::getSensorType(int handle) const { 
size_t count = mUserSensorList.size(); 
for (size ti-0 ; i<count ; i++) { 
const Sensor& sensor(mUserSensorList[i]); 
if (sensor.getHandle() == handle) ( 
return sensor.getType(); 
} 
} 


return -1; 


Vector<Sensor> SensorService::getSensorList() 


char value[PROPERTY VALUE MAX]; 
property get("debug.sensors", value, "0"); 
if (atoi(value)) ( 

return mUserSensorListDebug; 


) 
return mUserSensorList; 
} 
sp«ISensorEventConnection» SensorService::createSensorEventConnection() 
{ 
uid t uid = IPCThreadState::self()->getCallingUid(); 
sp<SensorEventConnection> result(new SensorEventConnection(this, uid)); 
return result; 
} 
void SensorService::cleanupConnection(SensorEventConnection* c) 
{ 


Mutex::Autolock _I(mLock); 
const wp<SensorEventConnection> connection(c); 
size_t size = mActiveSensors.size(); 
ALOGD_IF(DEBUG_CONNECTIONS, "%d active sensors", size); 
for (size_t i=0 ; i<size ; ) { 
int handle = mActiveSensors.keyAt(i); 
if (cC-»^hasSensor(handle)) ( 
ALOGD IF(DEBUG CONNECTIONS, "96i: disabling handle=0x%08x", i, handle); 
Sensorlnterface* sensor = mSensorMap.valueFor( handle ); 
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ALOGE_IF(!sensor, "mSensorMap[handle=0x%08x] is null!", handle); 
if (Sensor) { 
sensor->activate(c, false); 
} 
} 
SensorRecord* rec = mActiveSensors.valueAt(i); 
ALOGE_IF(!rec, "mActiveSensors[%d] is null (handle=0x%08x)!", i, handle); 
ALOGD IF(DEBUG CONNECTIONS, 
"removing connection %p for sensor[%d].handle=0x%08x", 
C, i, handle); 


if (rec && rec->removeConnection(connection)) ( 
ALOGD IF(DEBUG CONNECTIONS, "... and it was the last connection"); 
mActiveSensors.removeltemsAt(i, 1); 
mActiveVirtualSensors.removeltem(handle); 
delete rec; 
Size; 

)else( 
i++; 

} 


mActiveConnections.remove(connection); 
BatteryService::cleanup(c->getUid()); 
} 


status_t SensorService::enable(const sp<SensorEventConnection>& connection, 
int handle) 


if (mInitCheck != NO. ERROR) 
return mInitCheck; 


Mutex::Autolock _I(mLock); 
Sensorlnterface* sensor = mSensorMap.valueFor(handle); 
SensorRecord* rec = mActiveSensors.valueFor(handle); 
if (rec == 0) { 
rec = new SensorRecord(connection); 
mActiveSensors.add(handle, rec); 
if (sensor->isVirtual()) { 
mActiveVirtualSensors.add(handle, sensor); 
} 
}else { 
if (rec->addConnection(connection)) { 
/该 传感器 已 经 启动 ， 如 果 新 应 用 需要 连接 使 用 
// 则 立即 发 送 使 用 请 求 以 获取 传感器 的 值 
if (sensor->getSensor().getMinDelay() == 0) { 
sensors_event_t scratch; 
sensors_event_t& event(mLastEventSeen.editValueFor(handle)); 
if (event.version == sizeof(sensors_event_t)) { 
connection->sendEvents(&event, 1); 


} 
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} 


if (connection->addSensor(handle)) { 
BatteryService::enableSensor(connection->getUid(), handle); 
if (mActiveConnections.indexOf(connection) < 0) { 
mActiveConnections.add(connection); 
} 
) else { 
ALOGW("sensor %08x already enabled in connection %p (ignoring)", 
handle, connection.get()); 


// 设 置 使 用 传感器 
status t err = sensor ? sensor->activate(connection.get(), true) : status_t(BAD_VALUE); 


if (err = NO ERROR)( 
/启用 失败 ， 在 SensorDevice 复位 状态 
status_t resetErr = sensor ? sensor->resetStateWithoutActuatingHardware(connection.get(), 
handle) : status (BAD VALUE); 
/启用 失败 ， 处 于 复位 状态 
cleanupWithoutDisable(connection, handle); 


} 
return err; 
} 
status_t SensorService::disable(const sp<SensorEventConnection>& connection, 
int handle) 
{ 
if (mInitCheck != NO ERROR) 
return minitCheck; 
status t err = cleanupWithoutDisable(connection, handle); 
if (err == NO ERROR)( 
Sensorlnterface* sensor = mSensorMap.valueFor(handle); 
err = sensor ? sensor->activate(connection.get(), false) : status (BAD VALUE); 
) 
return err; 
} 
status_t SensorService::cleanupWithoutDisable(const sp<SensorEventConnection>& connection, 


int handle) { 
Mutex::Autolock _I(mLock); 
SensorRecord* rec = mActiveSensors.valueFor(handle); 
if (rec) { 
// 看 是 否 变 为 无 效 
if (connection->removeSensor(handle)) { 
BatteryService::disableSensor(connection->getUid(), handle); 
} 
if (connection->hasAnySensor() == false) { 
mActiveConnections.remove(connection); 
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// 传 感 器 是 否 变 为 无 效 
if (rec->removeConnection(connection)) { 
mActiveSensors.removeltem(handle); 
mActiveVirtualSensors.removeltem(handle); 
delete rec; 
} 
return NO_ERROR; 
} 
return BAD_VALUE; 
} 


status_t SensorService::setEventRate(const sp<SensorEventConnection>& connection, 
int handle, nsecs_t ns) 
{ 
if (mInitCheck != NO ERROR) 
return minitCheck; 


Sensorlnterface* sensor = mSensorMap.valueFor(handle); 
if (Isensor) 
return BAD_VALUE; 


if (ns < 0) 
return BAD_VALUE; 


nsecs t minDelayNs = sensor->getSensor().getMinDelayNs(); 
if (ns « minDelayNs) ( 
ns = minDelayNs; 


} 


if (ns < MINIMUM EVENTS PERIOD) 
ns = MINIMUM EVENTS PERIOD; 


return sensor-»setDelay(connection.get(), handle, ns); 


) 


———————— 


SensorService::SensorRecord::SensorRecord( 
const sp<SensorEventConnection>& connection) 


{ 
} 


bool SensorService::SensorRecord::addConnection( 
const sp<SensorEventConnection>& connection) 


mConnections.add(connection); 


{ 
if (mConnections.indexOf(connection) < 0) { 
mConnections.add(connection); 
return true; 
) 
return false; 
} 
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bool SensorService::SensorRecord::removeConnection( 
const wp<SensorEventConnection>& connection) 


{ 
ssize_t index = mConnections.indexOf(connection); 
if (index >= 0) { 
mConnections.removeltemsAt(index, 1); 
} 
return mConnections.size() ? false : true; 
} 


Il 


SensorService::SensorEventConnection::SensorEventConnection( 
const sp<SensorService>& service, uid_t uid) 
: mService(service), mChannel(new BitTube()), mUid(uid) 
{ 
} 


SensorService::SensorEventConnection::~SensorEventConnection() 

{ 
ALOGD_IF(DEBUG_CONNECTIONS, "~SensorEventConnection(%p)", this); 
mService->cleanupConnection(this); 


} 


void SensorService::SensorEventConnection::onFirstRef() 
{ 
} 


bool SensorService::SensorEventConnection::addSensor(int32_t handle) { 
Mutex::Autolock _I(mConnectionLock); 
if (mSensorlnfo.indexOf(handle) < 0) { 


mSensorlnfo.add(handle); 
return true; 

} 

return false; 


} 


bool SensorService::SensorEventConnection::removeSensor(int32_t handle) { 
Mutex::Autolock _I(mConnectionLock); 
if (mSensorlnfo.remove(handle) >= 0) { 
return true; 
} 
return false; 


} 


bool SensorService::SensorEventConnection::hasSensor(int32_t handle) const { 
Mutex::Autolock _I(mConnectionLock); 
return mSensorInfo.indexOf(handle) >= 0; 


} 


bool SensorService::SensorEventConnection::hasAnySensor() const { 
Mutex::Autolock _I(mConnectionLock); 
return mSensorinfo.size() ? true : false; 
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} 


status_t SensorService::SensorEventConnection::sendEvents( 
sensors_event_t const* buffer, size_t numEvents, 
sensors_event_t* scratch) 


// 筛 选 出 的 事件 不 用 于 此 连接 
size_t count = 0; 
if (scratch) { 
Mutex::Autolock I(mConnectionLock); 
size_t i=0; 
while (i<numEvents) { 
const int32_t curr = buffer[i].sensor; 
if (mSensorlnfo.indexOf(curr) >= 0) { 
do { 
scratch[count++] = buffer[i++]; 
} while ((isnumEvents) && (buffer[i].sensor == curr)); 
}еіѕе { 
i++; 
} 


) else { 
scratch = const_cast<sensors_event_t *>(buffer); 
count = numEvents; 


} 


11 ASensorEvent 和 sensors event t 是 同一 类 型 

ssize_t size = SensorEventQueue::write(mChannel, 
reinterpret_cast<ASensorEvent const*>(scratch), count); 

if (size == -EAGAIN) { 


return size; 

} 

return size < 0 ? status_t(size) : status_t(NO_ERROR); 
} 
sp<BitTube> SensorService::SensorEventConnection::getSensorChannel() const 
{ 

return mChannel; 
} 


status t SensorService::SensorEventConnection::enableDisable( 
int handle, bool enabled) 
{ 
status_t err; 
if (enabled) { 
err = mService->enable(this, handle); 
else { 
err = mService->disable(this, handle); 
} 


return err; 
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status_t SensorService::SensorEventConnection::setEventRate( 
int handle, nsecs_t ns) 


return mService->setEventRate(this, handle, ns); 


II 
y 
通过 上 述 实现 代码 ， 可 以 了 解 SensorService 服务 的 创建 、 启 动 过 程 ， 整 个 过 程 的 C/S 通信 架构 如 


图 10-5 所 示 。 


onFirstRefl) : void 


onincStrongAttemptedt) : void 
onLastStrongRefi) : void 
onLastWeskRet) void 


isBinderAlive() : void 
localBinder) : void 
remoteBinder()- void] 
transact() : void 


+ asBinder0 : sp<lBinder 


ISensorServer 


xS 


+ cesteSensorEventConnection() - ISensorEventConnection 
+ getSenscrListi) : Vector<Sensor 


+ queryLocalinterface() : sp«linterface» 


instantiate): void 

Я Publishi) : void 

о: publishAndJoinThreadPool() : void 
shutdown) void 


+ geateSensorEventConnection() : void 
* getSensorList) : void 


GreateSensorEventConnection() : void 
getSensorL ist): void 
) : void 
Seer ipe void 
onFirstRefl) : void 
onTransactl) : void 


EE 


+ geateEventQueue(): void 
+ getDefaultSensor) уза 
+ getSensorList) : void 


10-5 C/S 通信 架构 图 
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需要 注意 的 是 ， 并 没有 在 系统 中 用 BpSensorServer， 即 使 从 ISensorServer.cpp 中 把 它 删 除 也 不 会 对 
Sensor 的 工作 有 任何 影响 。 这 是 因为 它 的 工作 已 经 被 文件 SensorManager.cpp 所 取代 ，ServiceManager 
会 直接 获取 上 面 文件 System. init 中 添加 的 SensorService 对 象 。 


10.4.4 封装 HAL 层 的 代码 


在 Android 系统 中 ,通过 文件 frameworks/native/services/sensorservice/SensorDevice.cpp 封装 了 HAL 
层 的 代码 ， 此 文件 的 主要 功能 如 下 : 

М 获取 sensor 列表 (getSensorList)。 

М 获取 sensor 事 件 (poll)。 

Enable 或 Disable sensor (activate). 

М 设置 delay 时 间 。 

文件 SensorDevice.cpp 的 具体 实现 代码 如 下 : 


namespace android { 


жс нс сш кое и же тш 


ANDROID_SINGLETON_STATIC_INSTANCE(SensorDevice) 


SensorDevice::SensorDevice() 


mSensorDevice(0), 
mSensorModule(0) 
{ 
status_t err = hw_get_module(SENSORS_HARDWARE_MODULE_ID, 
(hw_module_t const**)&mSensorModule); 
ALOGE_IF(err, "couldn't load %s module (%s)", 
SENSORS_HARDWARE_MODULE_ID, strerror(-err)); 
if (mSensorModule) { 
err = sensors_open(&mSensorModule->common, &mSensorDevice); 
ALOGE_IF(err, "couldn't open device for module %s (%s)", 
SENSORS HARDWARE MODULE ID, strerror(-err)); 
if (mSensorDevice) ( 
sensor t const* list; 
Ssize t count = mSensorModule-»get sensors list(mSensorModule, &list); 
mActivationCount.setCapacity(count); 
Info model; 
for (size_t i-0 ; i<size_t(count) ; i++) { 
mActivationCount.add(list[i].handle, model); 
mSensorDevice->activate(mSensorDevice, list[i].handle, 0); 
} 
} 
} 
} 
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void SensorDevice::dump(String8& result, char* buffer, size_t SIZE) 


{ 

if (ImSensorModule) return; 
sensor t const list; 
ssize t count = mSensorModule-»get sensors list(mSensorModule, &list); 
snprintf(buffer, SIZE, "%а h/w sensors:\n", int(count)); 
result.append(buffer); 
Mutex::Autolock _I(mLock); 
for (size_t i=0 ; i<size_t(count) ; i++) { 

const Info& info = mActivationCount.valueFor(list{i].handle); 

snprintf(buffer, SIZE, "handle=0x%08x, active-count=%d, rates(ms)={ ", 

list{i].handle, 
info.rates.size()); 
result.append(buffer); 
for (size_t j=0 ; j<info.rates.size() ; j++) { 
snprintf(buffer, SIZE, "%4.1f%s", 
info.rates.valueAt(j) / 1e6f, 
j«info.rates.size()-1 ? ", " : ""); 
result.append(buffer); 

} 

snprintf(buffer, SIZE, " }, selected=%4.1f msn", info.delay / 1e6f); 

result.append(buffer); 
} 

} 


ssize_t SensorDevice::getSensorList(sensor_t const** list) { 
if ImSensorModule) return NO INIT; 
Ssize t count = mSensorModule-»get sensors list(mSensorModule, list); 
return count; 


) 


status t SensorDevice::initCheck() const ( 
return mSensorDevice && mSensorModule ? NO ERROR : NO INIT; 


) 


ssize t SensorDevice::poll(sensors event t* buffer, size t count) ( 
if (ImSensorDevice) return NO. INIT; 
ssize tc; 
do( 
c = mSensorDevice->poll(mSensorDevice, buffer, count); 
} while (c == -EINTR); 
return c; 


} 


status t SensorDevice::resetStateWithoutActuatingHardware(void *ident, int handle) 
Ë 

if (ImSensorDevice) return NO_INIT; 

Info& info( mActivationCount.editValueFor(handle)); 

Mutex::Autolock _I(mLock); 
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info.rates.removeltem(ident); 
return NO ERROR; 
} 


status t SensorDevice::activate(void* ident, int handle, int enabled) 


{ 
if (ImSensorDevice) return NO. INIT; 
status t err('NO ERROR); 
bool actuateHardware - false; 


Info& info( mActivationCount.editValueFor(handle) ); 


ALOGD IF(DEBUG CONNECTIONS, 


"SensorDevice::activate: ident=%p, handle=0x%08x, enabled=%d, count=%d", 


ident, handle, enabled, info.rates.size()); 


if (enabled) { 
Mutex::Autolock _I(mLock); 
ALOGD IF(DEBUG CONNECTIONS, "... index=%ld", 
info.rates.indexOfKey(ident)); 


if (info.rates.indexOfKey(ident) < 0) { 
info.rates.add(ident, DEFAULT EVENTS PERIOD); 
if (info.rates.size() == 1) ( 
actuateHardware - true; 
} 
}else { 
/传感器 已 经 激活 此 IDENT 


) else ( 
Mutex::Autolock  (mLock); 
ALOGD IF(DEBUG CONNECTIONS, "... index=%ld", 
info.rates.indexOfKey(ident)); 


ssize t idx 7 info.rates.removeltem(ident); 
if (idx >= 0) ( 
if (info.rates.size() == 0) { 
actuateHardware = true; 
} 
) else { 
/没有 启用 这 个 传感器 的 IDENT 
} 
} 


if (actuateHardware) { 
ALOGD IF(DEBUG CONNECTIONS, "\t>>> actuating h/w"); 


err = mSensorDevice->activate(mSensorDevice, handle, enabled); 
ALOGE_IF(err, "Error %s sensor %d (%s)", 
enabled ? "activating" : "disabling", 
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handle, strerror(-err)); 


} 


{// 范 围 为 锁 
Mutex::Autolock _I(mLock); 
nsecs_t ns = info.selectDelay(); 
mSensorDevice->setDelay(mSensorDevice, handle, ns); 


} 


return err; 


} 


status t SensorDevice::setDelay(void* ident, int handle, int64_t ns) 
{ 

if (ImSensorDevice) return NO. INIT; 

Mutex::Autolock l(mLock); 

Info& info( mActivationCount.editValueFor(handle) ); 

status t err - info.setDelayForldent(ident, ns); 

if (err « 0) return err; 

ns - info.selectDelay(); 

return mSensorDevice->setDelay(mSensorDevice, handle, ns); 


} 


int SensorDevice::getHalDeviceVersion() const { 
if ImSensorDevice) return -1; 


return mSensorDevice->common.version; 


status t SensorDevice::Info::setDelayForldent(void* ident, int64 t ns) 
{ 
ssize_t index = rates.indexOfKey(ident); 
if (index < 0) { 
ALOGE("Info::setDelayForldent(ident=%p, ns=%lld) failed (%5)", 
ident, ns, strerror(-index)); 
return BAD_INDEX; 
} 
rates.editValueAt(index) = ns; 
return NO ERROR; 
} 


nsecs_t SensorDevice::Info::selectDelay() 
{ 
nsecs_t ns = rates.valueAt(0); 
for (size_t i=1 ; i<rates.size() ; i++) { 
nsecs_t cur = rates. valueAt(i); 
if (cur < ns) { 
Ns = cur; 
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} 
delay = ns; 
return ns; 
} 
Il —— 
Б 


ІХ SensorSevice 会 把 任务 交 给 SensorDevice, 而 SensorDevice 会 调用 标准 的 抽象 层 接口 。 由 此 可 
见 ，Sensor 架构 的 抽象 层 接 口 是 最 标准 的 一 种 ， 它 很 好 地 实现 了 抽象 层 与 本 地 框架 的 分 离 。 


10.4.5 ”消息 队列 处 理 


在 Android 传 感 器 系统 中 ,文件 frameworks/native/libs/gui/SensorEventQueue.cpp 的 功能 是 处 理 消息 。 
文件 SensorEventQueue.cpp 能 够 在 创建 其 实例 时 传 入 SensorEventConnection 实例 ，SensorEventConnection 
继承 于 ISensorEventConnection 。 SensorEventConnection 其 实 是 客户 端 调用 SensorService 的 
createSensorEventConnection() 方 法 创建 的 , 是 客户 端 与 服务 端 沟通 的 桥梁 , 通过 这 个 桥梁 可 以 完成 如 下 
所 示 的 功能 。 

获取 管道 的 句柄 。 

М 往 管道 读 写 数据 。 

通知 服务 端 对 Sensor 使 能 。 

文件 frameworks/native/libs/gui/SensorEventQueue.cpp 的 具体 实现 代码 如 下 : 

eE eC URDU SPO OEP 


namespace android { 
eres 


т 


SensorEventQueue::SensorEventQueue(const sp<ISensorEventConnection>& connection) 
: mSensorEventConnection(connection) 


{ 
} 
SensorEventQueue::~SensorEventQueue() 
{ 
} 
void SensorEventQueue::onFirstRef() 
{ 
mSensorChannel = mSensorEventConnection->getSensorChannel(); 
} 
int SensorEventQueue::getFd() const 
{ 
return mSensorChannel->getFd(); 
} 


ssize_t SensorEventQueue::write(const sp<BitTube>& tube, 
ASensorEvent const* events, size_t numEvents) { 
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return BitTube::sendObjects(tube, events, numEvents); 


} 


ssize_t SensorEventQueue::read(ASensorEvent* events, size_t numEvents) 


{ 


return BitTube::recvObjects(mSensorChannel, events, numEvents); 


} 
sp<Looper> SensorEventQueue::getLooper() const 
{ 
Mutex::Autolock _I(mLock); 
if (mLooper == 0) { 
mLooper = new Looper(true); 
mLooper-»addFd(getFd(), getFd(), ALOOPER EVENT INPUT, NULL, NULL); 
} 
return mLooper; 
} 
status_t SensorEventQueue::waitForEvent() const 
{ 
const int fd = getFd(); 
sp<Looper> looper(getLooper()); 
int events; 
int32_t result; 
do { 
result = looper->pollOnce(-1, NULL, &events, NULL); 
if (result == ALOOPER_POLL_ERROR) { 
ALOGE("SensorEventQueue::waitForEvent error (errno=%d)", errno); 
result = -EPIPE; //unknown error, so we make up one 
break; 
} 
if (events & ALOOPER EVENT HANGUP) { 
ALOGE("SensorEventQueue::waitForEvent error HANGUP"); 
result = -EPIPE; //unknown error, so we make up one 
break; 
} 
} while (result != fd); 
return (result == fd) ? status_t(NO_ERROR) : result; 
} 
status_t SensorEventQueue::wake() const 
{ 
sp<Looper> looper(getLooper()); 
looper->wake(); 
return NO ERROR; 
} 


status_t SensorEventQueue::enableSensor(Sensor const* sensor) const { 
return mSensorEventConnection->enableDisable(sensor->getHandle(), true); 


—— À9—— 


) 


status t SensorEventQueue::disableSensor(Sensor const* sensor) const ( 
return mSensorEventConnection->enableDisable(sensor->getHandle(), false); 


} 


status t SensorEventQueue::enableSensor(int32_t handle, int32_t us) const { 
status_t err = mSensorEventConnection->enableDisable(handle, true); 
if (err == NO ERROR)( 
mSensorEventConnection->setEventRate(handle, us2ns(us)); 
} 
return err; 


} 


status t SensorEventQueue::disableSensor(int32_t handle) const { 
return mSensorEventConnection->enableDisable(handle, false); 


} 


status_t SensorEventQueue::setEventRate(Sensor const* sensor, nsecs_t ns) const { 
return mSensorEventConnection->setEventRate(sensor->getHandle(), ns); 


} 


pp 

y 

由 此 可 见 ，SensorManager 负责 控制 流 ， 通 过 C/S 的 Binder 机 制 与 SensorService 实现 通信 。 具 体 
过 程 如 图 10-6 所 示 。 


/frameworks/ba | 
se/libs/gui/Sens | 
orManager.cpp | 


lassertStateLocked| 


Senice('sensorsenice". &mSensorSeer]: 


ImSensors = mSensorServer-» getSensorlist(] 
ImSensorList[i] = mSensors array!) + i 


[mSensorSener»createSensor£ventConnection] — ] 


[SensorEventQueue-read (ASensorEvent" events. size_t numEvents) 


imSensorChannel-»read(events. numEvents"sizeof(events(0] 
[looper-» pollOnce(-1] 
SensorEventQueue 


imSensorEventConnection-»getSensorChannel(J: 
10-6 SensorManager 控制 流 的 处 理 流 程 
而 SensorEventQueue 负责 数据 流 ， 功 能 是 通过 管道 机 制 来 读 写 底层 的 数据 。 有 具体 过 程 如 图 10-7 所 示 。 


3) 
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i . .. SensorManager ` = _ SensorService E [ SensorDevice 1 
TBensorManager Sensotanaged) — ] | fframeworks/base/s 
== | ervices/sensorservi 
[assentStateloc [SensorSensce onF siRef) | e/SensorDevice.cp. 
ISenice['sensorsenice" AmSensorSener] BewoDeskieemeDesrgehseee] J  [SewopexeSessDexs] —]" 
, —— sl 
imSensors = mSensorSenver-» getSensorListi). Ihw get module(SENSORS HARDWARE, MODULE 1D. 
[mSensot istj] = mSensors апау) + i hw. module 1 const™"}&mSensortfodule) 


[sensors open(&mSensorModule s common. &mSensorDesce] 


|mSensodiodue s get sensors listimSensoriodule. list) 


(mSensoDeuce ractvateimSensorevce, hei] handle 0 


[mSensorSener->createSensorEventConnection() [new SensoréventConnectiontthis) 


TBensor£ventQusue read (ASensorEvent™ events. size 1 numEvents) 
[mSensorChannel-»read[events. numEvents sizecl{events[0)). 
R 
SensorEventQueue 
[SensorEventQueue опаа) _] 
[mSensoreveniConnecton->getSensorcha [SensorSenice Sensor£ventConnection gstSensorChannel] ] 


10-7 SensorEventQueue 数据 流 的 处 理 流 程 


10.5 HAL 层 详解 


Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 10 章 \HAL 层 详 解 .avi 
在 Android 系统 中 ，HAL 层 提供 了 Android 独立 于 具体 硬件 的 抽象 接口 。 其 中 HAL 层 的 头 文件 路 
径 是 hardware/libhardware/include/hardware/sensors.h。 


而 具体 实现 文件 需要 开发 者 个 人 编写 ， 有 具体 可 以 参考 hardware\invensense\libsensors_iio\sensors_ 


mpl.cpp。 
文件 sensors.h 的 主要 实现 代码 如 下 : 
typedef struct { 
union { 


struct { 
float azimuth; 
float pitch; 
float roll; 
> 
Y 
int8_t status; 
uint8 t reserved[3]; 
} sensors vec t; 


р 
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* 未 校准 陀螺 仪 和 磁场 数据 事件 
Si 
typedef struct ( 
union { 
float uncalib[3]; 
struct { 
float x_uncalib; 
float y_uncalib; 
float z uncalib; 
k 
IE 
union ( 
float bias[3]; 
struct ( 
float x bias; 
float y bias; 
floatz bias; 


y 
} uncalibrated event t; 


p 
* 各 种 类 型 的 传感器 数据 中 的 联合 
* 可 以 返回 
*l 

typedef struct sensors event t ( 

int32 t version; 
int32 t sensor; 


I” 传感器 类 型 */ 
int32_t type; 
int32 t reserved0; 


”时 间 ， 单 位 微 秒 */ 
int64_t timestamp; 
union { 

float data[16]; 


sensors_vec_t acceleration; 
sensors_vec_t magnetic; 
sensors_vec_t orientation; 
sensors_vec_t gyro; 

float temperature; 

float distance; 


float light; 
float pressure; 


float relative_humidity; 
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uint64_t step_counter; 
uncalibrated_event_t uncalibrated_gyro; 


uncalibrated_event_t uncalibrated_magnetic; 
k 
uint32 t reserved1[4]; 
) sensors event t; 


struct sensor t; 
struct sensors module t { 
struct hw module t common; 
int (get sensors list)(struct sensors module t* module, 
struct sensor t const list); 


Е 


struct sensor_t { 
const char* name; 


const char* vendor; 
int version; 
int handle; 


int type; 
float maxRange; 
float resolution; 


float power; 
int32_t minDelay; 


void* reserved[8]; 


} 


struct sensors_poll_device_t { 
struct hw_device_t common; 
int (*activate)(struct sensors poll device t “dev, 
int handle, int enabled); 
int (setDelay)(struct sensors poll device t *dev, 
int handle, int64 t ns); 
int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 
Е 
typedef struct sensors_poll_device_1 { 
union { 
struct sensors_poll_device_t v0; 


struct { 


struct hw_device_t common; 
int (*activate)(struct sensors poll device t *dev, 
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int handle, int enabled); 


int (*setDelay)(struct sensors poll device t *dev, 
int handle, int64 t period ns); 


int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 
E 
k 
int (*batch)(struct sensors poll device 1* dev, 
int handle, int flags, int64 t period ns, int64 t timeout); 


void (*reserved procs[8])(void); 


) sensors poll device 1 t; 


/* 用 于 打开 和 关闭 传感器 装置 */ 


static inline int sensors_open(const struct hw_module_t* module, 
struct sensors_poll_device_t** device) { 
return module->methods->open(module, 
SENSORS_HARDWARE_POLL, (struct hw_device_t**)device); 
} 


static inline int sensors_close(struct sensors_poll_device_t* device) { 
return device->common.close(&device->common); 


} 


static inline int sensors_open_1(const struct hw_module_t* module, 
sensors_poll_device_1_t** device) { 
return module->methods->open(module, 
SENSORS_HARDWARE_POLL, (struct hw_device_t**)device); 
} 


static inline int sensors_close_1(sensors_poll_device_1_t* device) { 
return device->common.close(&device->common); 


} 
. END DECLS 


#endif //ANDROID SENSORS INTERFACE Н 
而 具体 的 实现 文件 是 Linux Kernel 层 ， 也 就 是 具体 的 硬件 设备 驱动 程序 ， 例 如 可 以 将 其 命名 为 
sensors.c， 然 后 编写 如 下 定义 struct sensors poll device t 的 代码 。 


struct sensors poll device t { 
struct hw device t common; 


/激活 / 停 用 一 个 传感器 
int (*activate)(struct sensors poll device t *dev, 
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int handle, int enabled); 


// 对 于 一 个 给 定 的 传感器 ， 设 置 在 传感器 事件 之 间 的 时 间 延 迟 ， 单 位 微 秒 
int (*setDelay)(struct sensors poll device t “dev, 
int handle, int64 t ns); 


// 返 回 传感器 数据 的 数组 
int (*poll)(struct sensors poll device t *dev, 
sensors event t* data, int count); 


也 可 以 编写 如 下 定义 struct sensors module t 的 代码 。 
struct sensors module t { 


Б 


struct hw_module_t common; 


p 
* 枚 举 所 有 可 用 的 传感器 。 这 份 名 单 是 在 “名 单 ” 返 回 
*@ 传 感 器 在 列表 中 返回 数 
ki 

int (get sensors list)(struct sensors module t* module, 

struct sensor t const** list); 


也 可 以 编写 如 下 定义 struct sensor t 的 代码 。 
struct sensor_t { 


E 


const char* name; 
int version; 

int handle; 

int type; 

float maxRange; 
float resolution; 
float power; 
int32 t minDelay; 
void* reserved[8]; 


也 可 以 编写 如 下 定义 struct sensors event t 的 代码 。 
typedef struct { 


428 


union { 
float v[3]; 
struct { 
float x; 
float y; 
float 2; 
k 
struct ( 
float azimuth; 
float pitch; 
float roll; 
k 
E 
int8 t status; 
uint8 t reserved[3]; 
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} sensors vec t; 
typedef struct sensors event t ( 
int32 t version; 


int32 t sensor; 


int32 ttype; 
int32 t reserved0; 


int64 t timestamp; 

union ( 
float data[16]; 
sensors_vec_t acceleration; 
sensors_vec_t magnetic; 
sensors_vec_t orientation; 
sensors_vec_t gyro; 
float temperature; 
float distance; 
float light; 
float pressure; 
float relative_humidity; 

y 


uint32 t reserved1[4]; 
) sensors event t; 
也 可 以 编写 如 下 定义 struct sensors module t 的 代码 。 
static const struct sensor t sSensorList[] = { 
{"MMA8452Q 3-axis Accelerometer", 
"Freescale Semiconductor", 
1, SENSORS_HANDLE_BASE+ID_A, 


SENSOR TYPE ACCELEROMETER, 4.0f*9.81f, (4.0f*9.81f)/256.0f, 0.2f, 0, {}}, 


("AK8975 3-axis Magnetic field sensor", 

"Asahi Kasei", 

1, SENSORS HANDLE ВАЅЕ+0 M, 

SENSOR TYPE MAGNETIC FIELD, 2000.0f, 1.0f/16.0f, 6.8f, 0, {}}, 
{ "АК8975 Orientation sensor", 

"Asahi Kasei", 

1, SENSORS HANDLE BASE+ID О, 

SENSOR TYPE ORIENTATION, 360.0f, 1.0f, 7.0f, 0, (3). 


("ST 3-axis Gyroscope sensor", 
"STMicroelectronics", 
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1, SENSORS_HANDLE_BASE+ID_GY, 
SENSOR_TYPE_GYROSCOPE, RANGE_GYRO, CONVERT_GYRO, 6.1f, 1190, {}}, 


("AL3006Proximity sensor", 
"Dyna Image Corporation", 
1, SENSORS HANDLE ВАЅЕ+0 P, 
SENSOR TYPE PROXIMITY, 
PROXIMITY THRESHOLD CM, PROXIMITY THRESHOLD CM, 
0.5f, 0, (3), 


("AL3006 light sensor", 
"Dyna Image Corporation", 
1, SENSORS HANDLE BASE-ID L, 
SENSOR TYPE LIGHT, 10240.0f, 1.0f, 0.51, 0, () ), 


E 


static int open sensors(const struct hw module t* module, const char* name, 
struct hw device t** device); 


static int sensors get sensors list(struct sensors module t* module, 
Struct sensor t const"* list) 


*list = sSensorList; 
return ARRAY_SIZE(sSensorList); 
} 


static struct hw_module_methods_t sensors_module_methods = { 
.open = open sensors 


Е 


const struct sensors_module_t HAL_MODULE_INFO_SYM = { 
соттоп = ( 
‘tag = HARDWARE MODULE TAG, 
.version major = 1, 
.version minor = 0, 
id = SENSORS HARDWARE MODULE ID, 
.name = "MMA8451Q & AK8973A & gyro Sensors Module", 
.author = "The Android Project", 
.methods = &sensors module methods, 
) 
-get sensors list = sensors get sensors list 


ү 


static int open_sensors(const struct hw_module_t* module, const char* пате, 
struct hw_device_t** device) 


{ 


} 
Blt, + Android 系统 中 传感器 模块 的 源码 分 析 完 毕 。 由 此 可 见 ， 整 个 传感器 系统 的 总 体 调用 
关系 如 图 10-8 所 示 。 


return init_nusensors(module, device); // 待 后 面 讲解 
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图 10-8 传感器 系统 的 总 体 调用 关系 
客户 端 读 取 数 据 时 的 调用 时 序 如 图 10-9 所 示 。 
[el 


а ааай j "eren i 
Í 3 i sensors module IMO 'П { 


6 sensors. module get nestisensor() 


9 : register|stenerlmolO 


图 10-9 客户 端 读 取 数 据 时 的 调用 时 序 图 
服务 器 端的 调用 时 序 如 图 10-10 所 示 。 
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systemServer.java | | com android server SystemServerepo | | system nitepa | |SencorServiceenp | | Snsorinterfare cn | | SensorDevre cm || barewarec | | sensorn 


i ET i : 
Jcroid_server_SystemServer_initt G 


"qhw. get, module; 


9: 


{0 | sensors. poll device. t-»actNateQ— 


тї: өнөргө 
| E 


rogi 0°: 
Hardwaresensdr0 
ы I 


SF sprsors module Poet sensors Isti 


rund 


10-10 ”服务 器 端的 调用 时 序 图 


10.6 Android 传感器 应 用 开发 基础 


ГЮ 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 10 章 \Android 传感器 应 用 开发 基础 .avi 

在 本 章 前 面 的 内 容 中 ， 已 经 详细 讲解 了 Android 系统 中 传感器 系统 的 架构 知识 。 在 现实 应 用 中 ， 
传感器 系统 在 物 联 网 设备 、 可 穿戴 设备 和 家 具 设备 中 得 到 了 广泛 的 应 用 。 本 节 将 详细 讲解 开发 Android 
传感器 应 用 程序 的 基础 知识 ， 介 绍 使 用 传感器 技术 开发 物 联 网 设备 应 用 程序 的 基本 流程 ， 为 读者 步 入 
本 书后 面 知识 的 学 习 打 下 坚实 的 基础 。 


10.6.1 查看 包含 的 传感器 


在 安装 Android SDK 后 ， 依 次 打开 安装 目录 中 的 帮助 文件 android SDK/sdk/docs/reference/android/ 
hardware/Sensorhtml。 
在 此 文件 中 列 出 了 Android 传感器 系统 所 包含 的 所 有 传感器 类 型 ， 如 图 10-11 所 示 。 
另外 ,也 可 以 直接 在 线 登 录 http://developer.android.comvreference/android/hardware/Sensor.html ЖЖ 
看 。 由 此 可 见 ， 在 当前 最 新 (笔者 写 稿 时 最 新 ) 版 本 Android 4.4 中 一 共 提供 了 18 种 传感器 API。 各 个 
类 型 的 具体 说 明 如 下 。 
(1) TYPE ACCELEROMETER: 加 速度 传感器 ， 单 位 是 m/s*， 测 量 应 用 于 设备 X、Y、Z 轴 上 
的 加 速度 ， 又 叫做 G-sensor。 
(2) TYPE AMBIENT TEMPERATURE: 温度 传感器 ， 单 位 是 C， 能 够 测量 并 返回 当前 的 温度 。 


@ 
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Summary 
Android APIs APllevel: 28 = 
amara. gesture 
sna gaps 
I 
жеге pce roD int TYPE ACCELEROMETER A constant describing an accelerometer sensor type. 


android.graphics.drawable.shapes 
android. hardware int TYPE ALL A constant describing all sensor types. 
android hardware display š = 
жеч aident PER int TYPE AMBIENT TEMPERATURE A constant describing ап ambient temperature sensor type 

android.hardware location. int TYPE GAME ROTATION. VECTOR Identical to TYPE _ROTATI0N_VECTOR except that it doesn't use the geomagnetic field. 
android.hardwere usb. 


it TYPE GRAVITY A constant describing a gravity sensor type. 

android.inputmethodservice 

android location int TYPE GYROSCOPE A constant describing a gyroscope sensor type 

android media im TYPE GYROSCOPE UNCALIBRATED A constant describing a gyroscope uncalibrated sensor type. 

android. media.audiofx 

йй кайый imt TYPE LIGHT A constant describing a light sensor type. 

inuctor LL. int TYPE LINEAR ACCELERATION A constant describing a linear acceleration sensor type. 

Camera Area 

Camera.camerainto im TYPE MAGNETIC FIELD A constant describing a magnetic field sensor type. 

Ганна cers im TYPE MAGNETIC FIELD UNCALIBRATED A constant describing a magnetic field uncalibrated sensor type. 

Camera Parameters. 

Camera.Size int TYPE ORIENTATION This constant was deprecated in API leve 8 Use Sensorllanacer. getüriertationO instead. 
енен int TYPE PRESSURE А constant describing a pressure sensor type 

SensorEvent , int TYPE PROXIMITY А constant describing a proximity sensor type. 

Gained int TYPE RELATIVE HUMIDITY А constant describing a relative humidity sensor type. 

figgerEvent 
Понс рат XU ear ae 
int TVPE_SIGNIFICANT_MOTION A constant describing the significant motion trigger sensor. 
int TYPE TEMPERATURE This constant was deprecated in API level 14. use Senscs. TYPE_AMBIENT_TEWPERATURE instead. 

Use Tree Navication bel 
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(3) TYPE GRAVITY: 重力 传感器 ， 单 位 是 m/s: ， 用 于 测量 设备 X. Y. Z 轴 上 的 重力 ， 也 叫 
GV-sensor， 地 球 上 的 数值 是 9.8m/s* ， 也 可 以 设置 其 他 星球 。 

(4) TYPE GYROSCOPE: 陀螺 仪 传感器 ， 单 位 是 rad/s， 能 够 测量 设备 X、Y、Z 3 个 轴 的 角 加 
速度 数据 。 

(5) TYPE LIGHT: 光线 感应 传感器 ， 单 位 是 Ix， 能 够 检测 周围 的 光线 强度 ， 在 手机 系统 中 主要 
用 于 调节 LCD 亮度 。 

(6) TYPE LINEAR ACCELERATION: 线性 加 速度 传感器 ， 单 位 是 m/s* ， 能 够 获取 加 速度 传 感 
器 去 除 重力 的 影响 得 到 的 数据 。 

(7) TYPE MAGNETIC FIELD: 磁场 传感器 ， 单 位 是 khT〔 微 特 斯 拉 )， 能 够 测量 设备 周围 3 个 
物理 轴 (x,y,z》 的 磁场 。 

(8) TYPE ORIENTATION: 方向 传感器 ， 用 于 测量 设备 围绕 3 个 物理 轴 (xyz) 的 旋转 角度 ， 
在 新 版 本 中 已 经 使 用 SensorManager.getOrientation() ft. 

(9) TYPE PRESSURE: 气压 传感器 ， 单 位 是 hPa〈 百 帕斯卡 )， 能 够 返回 当前 环境 下 的 压强 。 

(10) TYPE PROXIMITY: 距离 传感器 ， 单 位 是 ecm， 能够 测量 某 个 对 象 到 屏幕 的 距离 。 可 以 在 
打 电 话 时 判断 人 耳 到 电话 屏幕 的 距离 ， 以 关闭 屏幕 而 达到 省 电 功 能 。 

(11) TYPE RELATIVE HUMIDITY: 湿度 传感器 ， 单 位 是 %， 能 够 测量 周围 环境 的 相对 湿度 。 

(12) TYPE_ROTATION_VECTOR: 旋转 向 量 传感器 ， 旋 转 矢量 代表 设备 的 方向 ， 是 一 个 将 坐标 
轴 和 角度 混合 计算 得 到 的 数据 。 

(13) TYPE TEMPERATURE: 温度 传感器 ， 在 新 版 本 中 被 TYPE AMBIENT TEMPERATURE 
替换 。 

(14) TYPE_ALL: 返回 所 有 的 传感器 类 型 。 

(15) TYPE GAME ROTATION VECTOR: 除了 不 能 使 用 地 磁场 之 外 ， 和 TYPE ROTATION - 
VECTOR 的 功能 完全 相同 。 

(16) TYPE_GYROSCOPE_UNCALIBRATED: 提供 了 能 够 让 应 用 调整 传感器 的 原始 值 ， 定 义 了 
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一 个 描述 未 校准 陀螺 仪 的 传感器 类 型 。 

(17) TYPE MAGNETIC FIELD UNCALIBRATED: 和 TYPE GYROSCOPE UNCALIBRATED 
相似 ， 也 提供 了 能 够 让 应 用 调整 传感器 的 原始 值 ， 定 义 了 一 个 描述 未 校准 陀螺 仪 的 传感器 类 型。 

(18) TYPE SIGNIFICANT MOTION: 运动 触发 传感器 ， 应 用 程序 不 需要 为 这 种 传感器 触发 任 
何 唤醒 锁 。 能 够 检测 当前 设备 是 否 运 动 ， 并 发 送 检测 结果 。 


10.6.2 ”模拟 器 测试 工具 一 一 SensorSimulator 


在 进行 和 传感器 相关 的 开发 工作 时 ， 使 用 SensorSimulator 测试 工具 可 以 提高 开发 效率 。 测 试 工具 
SensorSimulator 是 一 个 开源 免费 的 传感器 工具 ， 通 过 该 工具 可 以 在 模拟 器 中 调试 传感器 的 应 用 。 搭 建 
SensorSimulator 开发 环境 的 基本 流程 如 下 : 

(1) 下 载 SensorSimulator， 读 者 可 从 http://code.google.com/p/openintents/wiki/SensorSimulator 网 
站 找到 该 工具 的 下 载 链接 。 笔 者 下 载 的 是 
sensorsimulator-1.1.1.zip 版 本 , 如 图 10-12 所 示 。 @ openintents 

(2) 将 下 载 好 的 SensorSimulator 解压 到 本 mE 


ndroid applications work together 


地 at, ШС 录 。 Project Ноте | Downloads | Wiki Issues Source 
也 根 目录 例如 AIR 目录 | I Search | Gaver! dowriosds — B for|sensorsimultor = 
(3) 向 模拟 器 安装 SensorSimulatorSettings- 
1.1.1.apk。 首 先 在 操作 系统 中 依次 选择 “开始 ” Filename ¥ Summary + Labels v 
| “ 运行 ” fit 4 r BE X “ 运 行 ” 对 话 HE Я sensorsimulator-2 0-rc1 zip SensorSimulator 2.0-rc1 


sensorsimulator-1 1 1zip SensorSimulator 1.1.0 


(4) 在 “运行 ”对 话 框 中 输入 “cmd” 进 
入 сша 命令 行 , 之 后 通过 ed 命令 将 当前 目录 导 
航 到 SensorSimulatorSettings-1.1.1.apk 目录 下 ， 
然后 输入 下 列 命令 向 模拟 器 安装 该 apk。 
adb install SensorSimulatorSettings-1.1.1.apk 
需要 注意 的 是 , 安装 apk b, 一 定 要 保证 模拟 器 正在 运行 才 可 以 , 安装 成 功 后 会 输出 Success 提示 ， 
如 图 10-13 所 示 。 


图 10-12 下载 sensorsimulator-1.1.1.zip 


图 10-13 ”安装 apk 


下 面 开始 配置 应 用 程序 ， 假 设 要 在 项 目 jiaSCH 中 使 用 SensorSimulator， 则 配置 流程 如 下 : 

(1) 在 Eclipse 中 打开 项 目 jiaSCH， 然 后 为 该 项 目 添加 ТАК 包 ， 使 其 能 够 使 用 SensorSimulator 
工具 的 类 和 方法 。 添 加 方法 非常 简单 ， 在 Eclipse 的 Package Explorer 中 找到 该 项 目的 文件 夹 jiaSCH， 
然后 右 击 该 文件 夹 并 在 弹出 的 快捷 菜单 中 选择 Properties 命令 ,弹出 如 图 10-14 所 示 的 Properties for jiaS 
窗口 。 

(2) 选择 Java Build Path 选项 ， 然 后 选择 Libraries 选项 卡 ， 如 图 10-15 所 示 。 

(3) 单 击 Add External JARs 按钮 ， 在 弹出 的 JAR Selection 对 话 框 中 找到 Sensorsimulator 安装 目 
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3& FAN sensorsimulatorlib-1.1.1.jar， 并 将 其 添加 到 该 项 目 中 ， 如 


10-16 所 示 。 


Treject eferenees 
Refactoring stay 
алач Settings 

лик Easttery 

Tek Tees 
Ста 

Eo 


匠 mee J 
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pen 

perm 

E ders Cre Style 

E on Copier 

E Jons Iit 
Terabe Location 

| krajec: Metarenees 

алена History 

| кайы Settings 

$ Tek Mepesitory 
Task ses 

aa 

жыгаш 


[sensorsisulator-lib-L 1 1 jar 


Р 10-16 添加 需要 的 JAR 包 
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(4) 开始 启动 sensorsimulatorjar， 并 对 手机 模拟 器 上 的 SensorSimulatorSettings 进行 必要 的 配置 。 
首先 在 C:\sensorsimulator-1.1.1\bin 目录 下 找到 sensorsimulatorjar 并 启动 ， 运 行 后 的 界面 如 图 10-17 所 示 。 

(5) 进行 手机 模拟 器 和 SensorSimulator 的 连接 配置 工作 ， 运 行 手机 模拟 器 上 安装 好 的 
SensorSimulatorSettings.apk， 如 图 10-18 所 示 。 


=100х] 
Openintents Sensor Simulator [7] 
Yaw = G 
Piten с mcm ] 
Testing 
вш ———O 
wo -m0 ° ю аш 


Settings 
‘Supported sensors 192.168.1.6 


^ >] orientation 


Enabled sensors 


Da 


38.46 iZ) accelerometer 


| magnetic пеш 


图 10-17 传感器 的 模拟 器 图 10-18 ”运行 手机 模拟 器 上 的 SensorSimulatorSettings.apk 
(6) 在 图 10-18 中 输入 SensorSimulator 启动 时 显示 的 IP 地 址 和 端口 号 ， 单 击 Testing 按钮 后 会 进 


入 测试 连接 界面 ， 如 图 10-19 所 示 。 
(7) 单 击 Connect 按钮 进入 下 一 界面 ， 如 图 10-20 所 示 。 在 此 界面 中 可 以 选择 需要 监听 的 传感器 ， 
如 果 能 够 从 传感器 中 读 取 到 数据 ， 说 明 SensorSimulator 与 手机 模拟 器 连接 成 功 ， 可 以 测试 自己 开发 的 


应 用 程序 了 。 
ELE 
‘Sensor Simulator settings ‘Sensor Simulator settings 
ШШ. : ia 


BB ТЕ field Fastest лг 


i 


图 10-19 测试 连接 界面 图 10-20 连接 界面 
至 此 ， 使 用 Eclipse 结合 SensorSimulator 配置 传感器 应 用 程序 的 基本 流程 介绍 完毕 。 
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1063 ”实战 演练 一 一 检测 当前 设备 支持 的 传感器 


本 实例 将 演示 在 Android 设备 中 检测 当前 设备 支持 传感器 类 型 的 方法 。 
: = 例 | 功 & | 源码 路 径 
101 ү. 检测 当前 设备 支持 的 传感器 U __; 光盘 :vdaima\lO\SensorEX — : 
本 实例 的 功能 是 检测 当前 设备 支持 的 传感器 类 型 ， 具 体 实现 流程 如 下 。 
(1) 布局 文件 main.xml 的 具体 实现 代码 如 下 : 
<linearlayout android:layout height-"fill parent" android:layout_width="fill_parent" android:orientation="vertical" 
xmins:android="http://schemas.android.com/apk/res/android"> 
<textview android:layout height-"wrap content" 
android:layout width-"fill parent" android:text="" 
android:id="@+id/TextView01" 
> 
</textview> 
</linearlayout> 
(2) 主 程序 文件 MainActivity.java 的 具体 实现 代码 如 下 : 
public class MainActivity extends Activity { 


@SuppressWarnings("deprecation") 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


// 准 备 显示 信息 的 UI 组 件 
final TextView tx1 = (TextView) findViewByld(R.id.TextView01); 


// 从 系统 服务 中 获得 传感器 管理 器 
SensorManager sm = (SensorManager) getSystemService(Context.SENSOR_SERVICE); 


// 从 传感器 管理 器 中 获得 全 部 的 传感器 列表 
List<Sensor> allSensors = sm.getSensorList(Sensor.TYPE ALL); 


// 显 示 有 多 少 个 传感器 
tx1.setText(" 经 检测 该 手机 有 " + allSensors.size() + "个 传感器 ， 它 们 分 别 是 : w"); 


// 显 示 每 个 传感器 的 具体 信息 
for (Sensor s : allSensors) { 


String tempString = "\n" +" 设备 名 称 : "+s.getName()+"\n"+" 设备 版 本 : "+ 
s.getVersion() + ^n" + ”供应 商 : "+ s.getVendor() + "n"; 


switch (s.getType()) { 
case Sensor. TYPE_ACCELEROMETER: 
tx1.setText(tx1.getText()toString() + s.getType() + ”加 速度 传感器 accelerometer" 
+ tempString); 
break; 
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+ tempString); 


field" + tempString); 


tempString); 


* tempString); 


tempString); 


} 
} 


case Sensor. TYPE_GYROSCOPE: 
tx1.setText(tx1.getText().toString() + s.getType() + ”陀螺 仪 传感器 gyroscope" 


break; 

case Sensor.TYPE LIGHT: 
tx1.setText(ix1.getText()toSting()+s.getType()+" 环 境 光 线 传感器 ight" + tempString); 
break; 

case Sensor. TYPE_MAGNETIC_FIELD: 
tx1.setText(tx1.getText().toString() + s.getType() + "电磁场 传感器 magnetic 


break; 
case Sensor. TYPE_ORIENTATION: 
tx1.setText(bx1.getText().toString() + s.getType() + " 方向 传感器 orientation" + 


break; 
case Sensor. TYPE_PRESSURE: 
tx1.setText(bx1.getText()toString()*s.getType()*" 压力 传感器 pressure"+tempString); 
break; 
case Sensor. TYPE_PROXIMITY: 
tx1.setText(tx1.getText().toString() + s.getType() + ”距离 传感器 proximity" 


break; 
case Sensor. TYPE_AMBIENT_TEMPERATURE : 
tx1.setText(tx1.getText().toString() + s.getType() + ”温度 传感器 temperature" + 


break; 

default: 
tx1.setText(tx1 .getText().toString() + s.getType()+" 未 知 传感器 " + tempString); 
break; 

} 


上 述 实例 代码 需要 在 真 机 中 运行 , 执行 后 将 会 列表 显示 当前 设备 所 支持 的 传感器 类 型 ， 如 图 10-21 


所 示 。 


438 


第 11 章 CAI RESI Li S Ras 


在 Android 系统 中 支持 多 种 传感器 (Sensor)， 传 感 器 系统 可 以 让 智能 手机 的 功能 更 加 丰富 多 彩 。 
Android 系统 支持 多 种 传感器 ， 有 的 传感器 已 经 在 Android 的 框架 中 使 用 ， 大 多 数 传 感 器 由 应 用 程序 来 
使 用 ， 使 用 传感器 可 以 开发 出 包括 游戏 在 内 的 很 多 新 奇 的 应 用 。 在 Android 系统 中 支持 的 传感器 包括 
加 速度 传感器 (Accelerometer)、 姿 态 传感器 (Orientation)、 磁 场 传感器 (Magnetic Field) 和 光 传 感 器 

(Light) 等 。 本 章 将 详细 讲解 在 Android 物 联网 设备 中 使 用 光线 传感器 和 磁场 传感器 的 基本 知识 。 


11.1 光线 传感器 详解 


Фин 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 11 章 \ 光 线 传感器 详解 .avi 
ee нано ранна 555 度 和 键盘 灯 。 例 如 
在 光线 充足 的 地 方 屏幕 会 很 亮 ， 键 盘 灯 就 会 关闭 。 相 反 如 果 在 暗 处 ， 键 盘 灯 就 会 亮 ， 屏 幕 较 暗 〈 与 屏 
ee шз, Г». 
周期 性 闪 动 的 光 ， 非 常 美 观 。 本 节 将 详细 讲解 Android 系统 光线 传感器 的 基本 知识 。 


11.1.1 光线 传感器 介绍 


在 物 联网 设备 中 ， 光 线 传 感 器 通常 位 于 前 摄像 头 旁边 的 一 个 小 点 ， 如 果 在 光线 充足 的 情况 下 《〈 室 
外 或 者 是 灯光 充足 的 室内 )， 大 约 在 2 一 3 秒 之 后 键盘 灯会 自动 熄灭 ， 即 使 再 操作 机 器 键盘 灯 也 不 会 亮 ， 
除非 到 了 光线 比较 暗 的 地 方才 会 自动 亮 起 来 。 如果 在 光线 充足 的 情况 下 用 手 将 光线 感应 器 遮 上 , 在 2 一 
3 秒 后 键盘 灯会 自动 亮 起 来 ， 在 此 过 程 中 光线 感应 器 起 到 了 一 个 节 电 的 功能 。 

要 想 在 Android 物 联网 设备 中 监听 光线 传感器 ， 需 要 掌握 如 下 所 示 的 监听 方法 。 


(1) registerListenr(SensorListenerlistenr,int sensors,int rate): 已 过 时 。 


(2) registerListenr(SensorListenerlistenrint sensors): 已 过 时 。 
(3) registerListenr(SensorEventListenerlistenr,Sensor sensors,int rate): 注册 一 个 需要 监听 的 传感器 。 
(4) registerListenr(SensorEventListenerlistenr,Sensor sensors.int rate Handlerhandler): 因为 SensorListener 
已 经 过 时 ， 所 以 相应 的 注册 方法 也 过 时 了 。 
在 上 述 方法 中 ， 各 个 参数 的 具体 说 明 如 下 。 
Listener: 相应 监听 器 的 引用 。 
Sensor: 相应 感应 器 的 引用 。 
Rate: 感应 器 的 反应 速度 ， 这 个 必须 是 系统 提供 的 4 个 常量 之 一 。 
> SENSOR DELAY NORMAL: 匹配 屏幕 方向 的 变化 。 
> SENSOR DELAY UI: 匹配 用 户 接口 。 


HAA 


DU Android oe ae ACA 1813 


> SENSOR DELAY GAME: 匹配 游戏 。 
> SENSOR DELAY FASTEST: 匹配 所 能 达到 的 最 快 。 
开发 光 传感器 应 用 时 需要 监测 SENSOR. LIGHT， 例如 下 面 的 代码 。 


private SensorListener mySensorListener = new SensorListener(){ 


@Override 
public void onAccuracyChanged(int sensor, int accuracy) {}  //&& € onAccuracyChanged() 方 法 
@Override 
public void onSensorChanged(int sensor, float[] values) { 11% onSensorChanged() 方 法 
if(sensor == SensorManager.SENSOR LIGHT)( IRA EXER REB ЧА 
myTextView1.setText(" 光 的 强度 为 : "+values[0]); // 将 光 的 强度 显示 到 TextView 
} 
} 
y 
@Override 
protected void onResume() { // 重 写 onResume 方法 
mySensorManager.registerListener( /注册 监听 
mySensorListener, /监听 器 SensorListener 对 象 
SensorManager.SENSOR_LIGHT, /传感器 的 类 型 为 光 的 强度 
SensorManager.SENSOR_DELAY_UI /频率 
); 
super.onResume(); 


} 

TE LIRA, Ж ЧГ Ay ADT E НК АЕ a ak. ERIE P ЯА Gai САСА Н EE А 
理 ， 将 得 到 的 光 强 度 显示 在 屏幕 中 。 光 传感器 只 得 到 一 个 数据 ， 而 并 不 像 其 他 传感器 那样 得 到 的 是 x. 
Y. Z3 个 方向 上 的 分 量 。 

在 注册 监听 时 ， 通 过 传 入 SensorManagerSENSOR_LIGHT 来 通知 系统 只 注册 光 传 感 器 。 


11.1.2 ”使 用 光线 传感器 的 方法 


在 Android 物 联网 设备 中 ， 使 用 光线 传感器 的 基本 流程 如 下 : 

(1) 通过 一 个 SensorManager 来 管理 各 种 感应 器 ， 要 想 获得 这 个 管理 器 的 引用 ， 必 须 通过 如 下 所 

示 的 代码 来 实现 。 
(SensorManager)getSystemService(Context.SENSOR SERVICE); 

(2) 在 Android 系统 中 ， 所 有 的 感应 器 都 属于 Sensor 类 的 一 个 实例 ， 并 没有 继续 细 分 下 去 ， 所 以 
Android 对 于 感应 器 的 处 理 几乎 是 一 模 一 样 的 。 既 然 都 是 Sensor 类 ， 那 么 怎么 获得 相应 的 感应 器 呢 ? 
这 时 就 需要 通过 SensorManager 来 获得 ， 可 以 通过 如 下 所 示 的 代码 来 确定 我 们 要 获得 感应 器 的 类 型 。 

sensorManager.getDefaultSensor(Sensor.TYPE LIGHT); 
通过 上 述 代码 获得 光线 感应 器 的 引用 。 

(3) 在 获得 相应 的 传感器 的 引用 后 可 以 来 感应 光线 强度 的 变化 ， 此 时 需要 通过 监听 传感器 的 方式 
来 获得 变化 ， 监 听 功 能 通过 前 面 介绍 的 监听 方法 实现 。Android 提供 了 两 个 监听 方式 ， 一 个 是 
SensorEventListener， 另 一 个 是 SensorListener， 后 者 已 经 在 Android АРІ 上 显示 过 时 。 

(4) 在 Android 中 注册 传感器 后 ， 就 说 明 启 用 了 传感器 。 使 用 感应 器 是 相当 耗 电 的 ， 这 也 是 为 什 
么 传感器 的 应 用 没有 那么 广泛 的 主要 原因 ， 所 以 必须 在 不 需要 它 时 及 时 将 其 关 掉 。 在 Android 中 通过 
如 下 所 示 的 注销 方法 来 关闭 。 


@ 
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B unregisterListener(SensorEventListenerlistener) 
unregisterListener(SensorEventListenerlistener, Sensor sensor) 
(5) 使 用 SensorEventListener 来 具体 实现 ， 在 Android 物 联 网 设备 中 有 如 下 两 种 实现 该 监听 器 的 

方法 。 

onAccuracyChanged(Sensor sensor int accuracy): 是 反应 速度 变化 的 方法 ， 也 就 是 rate 变化 时 

的 方法 。 

onSensorChanged(SensorEvent event): 是 传感器 的 值 变化 的 相应 方法 。 

需要 注意 的 是 ， 上 述 两 个 方法 会 同时 响应 。 也 就 是 说 ， 当 感应 器 发 生变 化 时 ， 这 两 个 方法 会 一 起 
被 调用 。 上 述 方法 中 accuracy 的 值 是 4 个 常量 ， 对 应 的 整数 如 下 所 示 。 
SENSOR DELAY NORMAL: 3。 
SENSOR DELAY UI: 2. 
SENSOR DELAY GAME: 1. 
SENSOR DELAY FASTEST: 0. 

E SensorEvent 有 4 个 成 员 变 量 ， 有 具体 说 明 如 下 所 示 。 

Accuracy: 精确 值 。 

Sensor: 发 生变 化 的 感应 器 。 

M Timestamp: 发 生 的 时 间 ， 单 位 是 纳 秒 。 

回 Values: 发 生变 化 后 的 值 ， 这 是 一 个 长 度 为 3 的 数组 。 

光线 传感器 只 需要 values[0] 的 值 ， 其 他 两 个 都 为 0。 而 values[0] 就 是 开发 光线 传感器 所 需要 的 , 单 
位 是 klux， 表 示 光 线 强 度 。 


11.1.3 ”实战 演练 一 一 获取 设备 中 光线 传感器 的 值 
本 实例 将 演示 在 Android 物 联网 设备 中 使 用 光线 传感器 的 方法 。 


本 实例 的 功能 是 获取 设备 中 光线 传感器 的 值 ， 具 体 实 现 流程 如 下 所 示 。 
(1) 编写 布局 文件 activity_main.xml， 具 体 实现 代码 如 下 : 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android” 
xmins:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:paddingBottom-"(g)dimen/activity vertical margin" 
android:paddingLeft-"(dimen/activity horizontal margin" 
android:paddingRight-"(Qdimen/activity horizontal margin" 
android:paddingTop-"(dimen/activity vertical margin" 
tools:context-" MainActivity" > 
«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/hello_world" /> 
</RelativeLayout> 


Android 物 联 网 开发 从 入 门 到 实战 


(2) 编写 程序 文件 MainActivityjava， 具 体 实现 代码 如 下 : 


package com.example.sensor; 


import android.hardware.Sensor; 

import android.hardware.SensorEvent; 

import android.hardware.SensorEventListener; 
import android.hardware.SensorListener; 
import android.hardware.SensorManager; 
import android.os.Bundle; 

import android.renderscript.Sampler.Value; 
import android.app.Activity; 

import android.view.Menu; 

import android.widget.TextView; 


public class MainActivity extends Activity implements SensorEventListener ( 


private SensorManager sensor; 

private TextView text; 

@Override 

protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity_main); 
sensor = (SensorManager)getSystemService(SENSOR_SERVICE); 
text = (TextView)findViewByld(R.id.textView1); 

} 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.activity main, menu); 
return true; 


) 


@Override 

protected void onPause() { 
sensor.unregisterListener(this); 
super.onPause(); 


} 


@Override 
protected void onResume() { 


sensor.registerL istener(this,sensor.getDefaultSensor(Sensor.TYPE LIGHT),SensorManager.SENSOR D 
ELAY GAME); 
super.onResume(); 


} 


@Override 
protected void onStop() { 
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sensor.unregisterListener(this); 
super.onStop(); 


@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 


} 


@Override 

public void onSensorChanged(SensorEvent event) { 
float[] values = event.values; 
int sensorType = event.sensor. TYPE LIGHT; 
if(sensorType--Sensor.TYPE LIGHT) 
{ 


text.setText(String.valueOf(values[0])); 


} 
} 


在 真 机 中 执行 后 ， 将 会 显示 设备 中 光线 传感器 的 值 。 
11.1.4 ”实战 演练 一 一 显示 设备 中 光线 传感器 的 强度 
本 实例 将 演示 在 Android 物 联网 设备 中 使 用 光线 传感器 的 方法 。 


本 实例 的 功能 是 显示 设备 中 光线 传感器 的 强度 值 ， 具 体 实现 流程 如 下 所 示 。 
(1) fE Eclipse 工程 中 引入 两 个 开源 开发 包 ， 如 图 11-1 所 示 。 
4 Ë libs 


llli android-support-v4jar 
Ё sensorsimulator-lib-1.1.1ar 


图 11-1 引入 开发 包 
(2) 编写 布局 文件 main.xml， 具 体 实现 代码 如 下 : 


<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
xmins:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:orientation-" vertical" > 


«TextView 
android:id="@+id/myTextView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 

> 


Android 物 联 网 开发 从 入 门 到 实战 


</LinearLayout> 
(3) 编写 值 文件 string.xml， 有 具体 实现 代码 如 下 : 
<resources> 
<string name="app_name">Sample</string> 
«string name="title"> 光 传感器 </string> 
<string name="hello_world">Hello world!</string> 
<string name="menu_settings">Settings</string> 
</resources> 
(4) 编写 主 程序 文件 MainActivityjava， 具 体 实现 代码 如 下 : 
package com.example.qiang; 
import org.openintents.sensorsimulator.hardware.Sensor; 
import android.app.Activity; 
import android.hardware.SensorManager; 
import android.os.Bundle; 
import android.widget.TextView; 


public class MainActivity extends Activity implements android.hardware.SensorEventListener { 
private TextView myTextView1; 
private SensorManager mySensorManager; 


@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
myTextView1 = (TextView) findViewByld(R.id.myTextView1); 
mySensorManager = (SensorManager) getSystemService(SENSOR_SERVICE); 


} 


@Override 
protected void onResume() { 
mySensorManager.registerListener( 
this, 
mySensorManager.getDefaultSensor(Sensor.TYPE LIGHT), 
SensorManager.SENSOR DELAY GAME 
y 
super.onResume(); 


} 


@Override 

protected void onStop() { 
mySensorManager.unregisterListener(this); 
super.onStop(); 

} 

@Override 

protected void onPause() { 


mySensorManager.unregisterListener(this); 
e. 
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super.onPause(); 


} 


@Override 
public void onAccuracyChanged(android.hardware.Sensor sensor, int accuracy) { 


} 


@Override 
public void onSensorChanged(android.hardware.SensorEvent event) { 
float[] values = event.values; 
int sensorType = event.sensor. TYPE_LIGHT; 
if (sensorType == Sensor. TYPE_LIGHT) { 
myTextView1.setText(" 当 前 光 的 强度 为 : "*values[0]); 
} 
} 


11.2 ”磁场 传感器 详解 


Фин 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 11 章 \ 磁 场 传感器 详解 .avi 

在 现实 应 用 中 , 经常 需要 检测 Android 设备 的 方向 ， 例 如 设备 的 朝向 和 移动 方向 。 在 Android 系统 
中 ， 通 常 使 用 重力 传感器 、 加 速度 传感器 、 磁 场 传感器 和 旋转 矢量 传感器 来 检测 设备 的 方向 。 本 节 将 
详细 讲解 在 Android 设备 中 使 用 磁场 传感器 检测 设备 方向 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 
习 打 下 基础 。 


11.21 什么 是 磁场 传感器 


磁场 传感器 是 可 以 将 各 种 磁场 及 其 变化 的 量 转变 成 电信 号 输出 的 装置 。 自 然 界 和 人 类 社会 生活 的 
许多 地 方 都 存在 磁场 或 与 磁场 相关 的 信息 。 磁 场 传感器 是 利用 人 工 设 置 的 永久 磁体 产生 的 磁场 ， 可 以 
作为 许多 种 信息 的 载体 ， 被 广泛 用 于 探测 、 采 集 、 存 储 、 转 换 、 复 现 和 监控 各 种 磁场 和 磁场 中 承载 的 
各 种 信息 的 任务 。 在 当今 的 信息 社会 中 ， 磁 场 传感器 已 成 为 信息 技术 和 信息 产业 中 不 可 缺少 的 基础 元 
件 。 目 前 ， 人 们 已 研制 出 利用 各 种 物理 、 化 学 和 生物 效应 的 磁场 传感器 ， 并 已 在 科研 、 生 产 和 社会 生 
活 的 各 个 方面 得 到 广泛 应 用 ， 承 担 起 探究 种 种 信息 的 任务 。 

在 现实 市 面 中 ， 最 早 磁场 传感器 是 伴随 测 磁 仪 器 的 进步 而 逐步 发 展 的 。 在 众多 的 测试 磁场 方法 中 ， 
大 多 都 是 将 磁场 信息 变 成 电信 号 进行 测量 。 在 测 磁 仪 器 中 “探头 ”或 “取样 装置 ”就 是 磁场 传感器 。 
随 着 信息 产业 、 工 业 自动 化 、 交 通 运 输 、 电 力 电子 技术 、 办 公 自 动 化 、 家 用 电器 、 医 疗 仪器 等 的 飞速 
发 展 和 电子 计算 机 应 用 的 普及 ， 需 用 大 量 的 传感器 将 需 进行 测量 和 控制 的 非 电 参量 ， 转 换 成 可 与 计算 
机 兼容 的 信号 ， 作 为 它们 的 输入 信号 ， 这 就 给 磁场 传感器 的 快速 发 展 提供 了 机 会 ， 形 成 了 相当 可 观 的 
磁场 传感器 产业 。 
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11.2.2 ”磁场 传感器 的 分 类 


在 现实 应 用 中 ， 磁 场 传感器 的 主要 分 类 如 下 所 示 。 

(1) 薄膜 磁 致 电阻 传感器 

铁 磁性 物质 在 磁化 过 程 中 ， 它 的 电阻 值 沿 磁化 方向 增加 ， 并 达到 饱和 的 现象 称 为 磁 阻 效应 。 薄 膜 
磁 阻 元 件 是 利用 薄膜 工艺 和 微细 加 工 技术 , 将 NiPe、NiCo 合金 用 真空 燕 镇 或 溯 射 工艺 沉积 到 硅 片 或 铁 
氧 体 基 片上 , 通过 微细 加 工 技 术 制 成 一 定形 状 的 磁 咀 图 形 , 形成 三 端 式 、 四 端 式 以 及 多 端 式 器 件 。 BMber 
结构 桥 式 电路 磁 阻 元 件 具 有 灵敏 度 高 、 工 作 频 率 特性 好 、 温 度 稳定 性 好 、 结 构 简 单 、 体 积 小 等 特点 。 
可 制 成 高 密度 磁 咀 磁头 、 磁 性 编码 器 、 磁 阻 位 移 传感器 、 磁 阻 电流 传感器 等 。 

(2) 磁 阻 敏感 器 

物质 在 磁场 中 电阻 发 生变 化 的 现象 称 为 磁 阻 效应 。 对 于 铁 、 钴 、 镍 及 其 合金 等 强 磁性 金属 ， 当 外 
加 磁场 平行 于 磁体 内 部 磁化 方向 时 ， 电 阻 几乎 不 随 外 加 磁场 变化 ; 当 外 加 磁场 偏离 金属 的 内 磁化 方向 
时 ， 此 类 人 金属 的 电阻 值 将 减 小 ， 这 就 是 强 磁 金 属 的 各 向 异性 磁 阻 效应 。 

(3) 电 涡流 式 传 感 器 

近年 来 ， 国 内 外 正 发 展 建立 在 电 涡 流 效 应 原理 上 的 传感器 ， 即 电 涡流 式 传感器 。 这 种 传感器 不 但 
具有 测量 线性 范围 大 、 灵 敏 度 高 、 结 构 简单 、 抗 干扰 能 力 强 、 不 受 油污 等 介质 的 影响 等 优点 ， 而 且 又 
具有 无 损 、 非 接触 测量 的 特点 ， 目 前 正 广泛 地 应 用 于 工业 各 部 门 中 的 位 移 、 尺 寸 、 厚 度 、 振 动 、 转 速 、 
压力 、 电 导 率 、 温 度 、 波 面 等 测量 ， 以 及 探测 金属 材料 和 加 工件 表面 裂纹 及 缺陷 。 

(4) 磁性 液体 加 速度 传感器 

磁性 液体 作为 一 种 新 型 的 纳米 功能 材料 ， 一 经 问世 便 走 到 科学 技术 发 展 的 前 沿 ， 目 前 科学 家 们 已 
经 将 这 种 新 型 功能 材料 应 用 到 广阔 的 领域 中 。 以 此 为 基础 的 磁性 液体 传感器 技术 也 引起 了 国际 技术 领 
域 广泛 的 关注 。 

(5) 磁性 液体 水 平 传感器 

磁性 液体 传感器 的 研究 与 应 用 起 源 于 美国 。 早 在 1983 年 美国 新 墨西哥 州 阿 尔 帕克 基 应 用 技术 公司 
就 与 美国 空军 签订 了 合同 ， 美 国 新 墨西哥 州 阿尔 帕克 基 应 用 技术 公司 便 开始 研制 基于 磁性 液体 动力 学 
原理 (MHD) 的 主动 式 和 被 动 式 传感器 。 磁 性 液体 传感器 应 用 领域 很 广 ， 既 可 以 应 用 到 民用 上 ， 也 可 
以 应 用 到 军工 上 ， 有 其 他 传感器 所 代替 不 了 的 功能 ， 正 因为 如 此 ， 国 外 比较 早 地 意识 到 开发 磁性 液体 
传感器 的 意义 ， 并 且 已 开始 了 研究 和 生产 ， 并 将 该 种 传感器 应 用 到 航空 、 航 天 、 宇 航 站 等 尖端 军事 领 
dk. 美国 、 法 国 、 德 国 、 俄 罗斯 、 日 本 和 罗马 尼 亚 等 国家 已 开始 利用 磁性 液体 来 制作 各 种 传感器 。 磁 
性 液体 水 平 传感器 对 控制 机 器 人 工作 状态 ， 使 太阳 能 栅 板 保持 朝向 太阳 ， 使 抛物 天 线 持续 朝向 通信 系 
统 中 的 人 造 卫星 等 方面 有 着 重要 的 应 用 。 目 前 国外 已 研制 出 单 轴 、 双 轴 、3 轴 等 类 型 的 磁性 液体 水 平 传 
感 器 ， 而 我 国有 关 磁 性 液体 传感器 的 研究 尚 处 于 实验 和 探索 阶段 。 


11.2.3 Android 系统 中 的 磁场 传感器 


在 Android 系统 中 ， 磁 场 传感器 TYPE МАСМЕТІС FIELD， 单位 是 nT( 微 特 斯 拉 )， 能 够 测量 设 
备 周围 3 个 物理 轴 (xyz) 的 磁场 。 在 Android 设备 中 ， 磁 场 传感器 主要 用 于 感应 周围 的 磁感应 强度 ， 
在 注册 监听 器 后 主要 用 于 捕获 如 下 3 个 参数 : 


e. 


sue xacesnusces | 


E] values[0] 
М values[l] 
values[2] 
ER 3 个 参数 分 别 代表 磁感应 强度 在 空间 坐标 系 中 3 个 方向 轴 上 的 分 量 。 所 有 数据 的 单位 为 uT, 
即 微 特 斯 拉 。 
在 Android 系统 中 ， 磁 场 传感器 主要 包含 如 下 所 示 的 公共 方法 。 
int getFifoMaxEventCount(): 返回 该 传感器 可 以 处 理事 件 的 最 大 值 。 如 果 该 值 为 0， 表 示 当 前 
模式 不 支持 此 传感器 。 
int getFifoReservedEventCount(): 保留 传感器 在 批 处 理 模式 中 FIFO 的 事件 数 ， 给 出 了 一 个 保 
证 可 以 分 批 事 件 的 最 小 值 。 
float getMaximumRange(): 传感器 单元 的 最 大 范围 。 
int getMinDelay(): 最 小 延迟 。 
String getName(): 获取 传感器 的 名 称 。 
floa getPower(): 获取 传感器 电量 。 
float getResolution0: 获得 传感器 的 分 辨 率 。 
int ве(Туре(): 获取 传感器 的 类 型 。 
String getVendor(): 获取 传感器 的 供应 商 字 符 串 。 
Int etVersion0: 获取 该 传感器 模块 版 本 。 
String toString): 返回 一 个 对 当前 传感器 的 字符 串 描述 。 


11.2.4 ”实战 演练 一 一 获取 磁场 传感器 的 3 个 分 量 
本 实例 将 演示 在 Android 设备 中 使 用 磁场 传感器 的 方法 。 
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x ø x 能 源码 路 径 
eee. ИИИ 使 用 磁场 传感器 | | l... 光盘 :daima\llvcichangEX — 
本 实例 的 实现 文件 是 cichangLILjava， 在 此 文件 中 定义 了 监听 器 类 对 象 和 注册 监听 的 方法 。 主 要 代 
码 如 下 所 示 。 


public class cichangLI extends Activity { 

TextView myTextView1 ;//x 方向 磁场 分 量 

TextView myTextView2;//y 方向 磁场 分 量 

TextView myTextView3;//z 方向 磁场 分 量 

//SensorManager mySensorManager;// 引 用 SensorManager 对 象 

SensorManagerSimulator mySensorManager;// 声 明 SensorManagerSimulator 对 象 ， 调 试 时 用 

@Override 

public void onCreate(Bundle savedInstanceState) (//& 5 onCreate() 方 法 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main);// 当 前 的 用 户 界面 
myTextView1 = (TextView) findViewByld(R.id.myTextView1);// 得 到 myTextView1 引用 
myTextView2 = (TextView) findViewByld(R.id.myTextView2);// 得 到 myTextView2 引用 
myTextView3 = (TextView) findViewByld(R.id.myTextView3):// 得 到 myTextView3 引用 
/调试 时 用 
mySensorManager = SensorManagerSimulator.getSystemService(this, SENSOR_SERVICE); 
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mySensorManager.connectSimulator(); /连接 Simulator 服务 器 
} 
@SuppressWarnings("deprecation") 
private SensorListener mySensorListener = new SensorListener(){ 


@Override 

public void onAccuracyChanged(int sensor, int accuracy) {} 11% onAccuracyChanged() 方 法 
@Override 

public void onSensorChanged(int sensor, float[] values) { 11% опЅепѕогСһапде() 5% 


if(sensor == SensorManager.SENSOR MAGNETIC FIELD)( /检查 磁场 的 变化 
myTextView1.setText("x 方向 的 磁场 分 量 为 : "+values[0]);// 数 据 显 示 在 TextView 
myTextView2.setText("y 方向 的 磁场 分 量 为 : "+values[1]);// 数 据 显 示 在 TextView 
myTextView3.setText("z 方向 的 磁场 分 量 为 : "+values[2]);// 数 据 显 示 在 TextView 


} 
} 
ү 
@Override 
protected void onResume() { // 重 写 onResume() 方 法 
mySensorManager.registerListener( /注册 监听 
mySensorListener, /监听 器 SensorListener 对 象 
SensorManager.SENSOR_MAGNETIC_FIELD, /传感器 的 类 型 为 加 速度 
SensorManager.SENSOR_DELAY_UI /传感器 事件 传递 的 频 度 
y 
super.onResume(); 
} 
@Override 
protected void onPause() { // 重 写 onPause() 方 法 
// 取 消 注册 监听 器 
mySensorManager.unregisterListener((SensorEventListener) mySensorListener); 
super.onPause(); 
} 


} 
因为 本 实例 比较 简单 ， 是 根据 SensorSimulator 中 附带 的 开源 代码 改编 的 ， 所 以 在 此 不 再 进行 详细 
介绍 ， 读 者 只 需 阅 读本 书 附带 光盘 中 的 源码 即 可 。 


11.2.5 “实战 演练 一 一 演示 常用 传感器 的 基本 用 法 


本 实例 将 演示 在 Android 设备 中 使 用 常用 传感器 的 基本 方法 。 


(1) 实现 布局 文件 


布局 文件 main.xml 的 功能 是 使 用 ListView 控件 列表 显示 常用 的 传感器 类 型 ， 具 体 实现 代码 如 下 : 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
«ListView android:id="@+id/ListView01" 


android:layout width-"wrap content" 


@ 
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android:layout_height="wrap_content"/> 
</LinearLayout> 
(2) 实现 程序 文件 
主 Activity 的 实现 文件 是 HelloSensorjava， 功 能 是 响应 用 户 选择 的 传感器 来 执行 对 应 的 处 理 程序 ， 
具体 实现 代码 如 下 : 
public class HelloSensor extends Activity { 
/5 个 范例 的 菜单 名 称 和 应 用 程序 Class 
private Object[] activities = { 
"Compass", CompassDemo.class, 
"Orientation" OrientationDemo.class, 
“Accelerometer” AccelerometerDemo.class, 
"Magnetic Field", MagneticFieldDemo.class, 
"Temperature", TemperatureDemo.class, 


Е 

//HelloSensor 主 程式 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 
/建立 5 个 范例 菜单 名 称 的 数组 list 
CharSequence[] list = new CharSequence[activities.length / 2]; 
for (int i = 0; i < list.length; i++) { 

list[i] = (String)activities[i * 2]; 


} 
// 将 5 个 范例 菜单 名 称 放置 在 listView 
ArrayAdapter<CharSequence> adapter = new ArrayAdapter<CharSequence>(this, android.R.layout. 
simple list item 1, list); 
ListView listView = (ListView)findViewByld(R.id.ListView01); 
listView.setAdapter(adapter); 
// 按 下 菜单 名 称 指向 相关 的 应 用 程序 Class 
listView.setOnltemClickListener(new OnltemClickListener() { 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) { 
Intent intent = new Intent(HelloSensor.this, (Class<?>)activities[position * 2 + 1]); 


startActivity(intent); 
} 
六 
} 
当 在 主 Activity 界面 选择 CompassDemo 选项 后 , 会 执行 文件 CompassDemo.java 启动 罗盘 传感器 ， 
具体 实现 代码 如 下 : 


public class CompassDemo extends Activity implements SensorEventListener { 
private SensorManager sensorManager; 
private MySurfaceView view; 
private Object[] orientation = { 
"Rotate Z-axis Orientation", "Rotate X-axis Orientation","Rotate Y-axis Orientation", 
k 
/CompassDemo 主 程序 
@Override 
public void onCreate(Bundle savedinstanceState) { 
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super.onCreate(savedinstanceState); 
sensorManager = (SensorManager)getSystemService(SENSOR_SERVICE); 
view = new MySurfaceView(this); 


setContentView(view); 
} 
@Override 
protected void onResume() { 
super.onResume(); 
List<Sensor> sensors = sensorManager.getSensorList(Sensor.TYPE ORIENTATION); 
if (sensors.size() > 0) ( 
sensorManager.registerl istener(this, sensors.get(0), SensorManager.SENSOR_DELAY_ NORMAL); 
) 
} 
@Override 
protected void onPause() { 
super.onPause(); 


sensorManager.unregisterListener(this); 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 


public void onSensorChanged(SensorEvent event) { 
view.onValueChanged(event.values); 


class MySurfaceView extends SurfaceView implements SurfaceHolder.Callback { 
private Bitmap bitmap,curBitmap; 
private float x, у, 2, delta=-8; 
private int curWidth, curHeight; 
public MySurfaceView(Context context) { 
super(context); 
getHolder().addCallback(this); 
bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.compass); 


} 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
x = getWidth()/2; 
y = getHeight()/2; 
onValueChanged(new float[3]); 
} 
public void surfaceCreated(SurfaceHolder holder) { 
} 
public void surfaceDestroyed(SurfaceHolder holder) { 
} 
@SuppressWarnings("static-access") 
void onValueChanged(float[] values) { 
Canvas canvas = getHolder().lockCanvas(); 
if (canvas != null) { 
Paint paint = new Paint(); 
paint.setAntiAlias(true); 
paint.setColor(Color.BLUE); 
paint.setTextSize(24); 
canvas.drawColor(Color.WHITE); 
canvas.save(); 
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Matrix matrix = new Маїпх(); 
curWidth = (int) (bitmap.getWidth()* 1); 
curHeight = (int) (bitmap.getHeight()* 1); 
curBitmap = bitmap.createScaledBitmap(bitmap, curWidth, curHeight, false); 
matrix.setRotate(-values[0]+delta, x , y ); 
canvas.setMatrix(matrix); 
canvas.drawBitmap(curBitmap, x-curWidth/2, y-curHeight/2, null); 
canvas.restore(); 
for (int i = 0; i < values.length; i++) { 
canvas.drawText(orientation[i] + ":" + values], 0, paint.getTextSize() * (i + 1), paint); 


getHolder().unlockCanvasAndPost(canvas); 


} 
} 
"ATE XE. Activity 界面 选择 AccelerometerDemo 选项 后 ， 会 执行 文件 AccelerometerDemo.java 启动 加 
速 计 传感器 ， 具 体 实现 代码 如 下 : 
public class AccelerometerDemo extends Activity implements SensorEventListener { 
private SensorManager sensorManager; 
private MySurfaceView view; 
private Object[] accelerometer = { 
"X-axis Accelerometer", "Y-axis Accelerometer","Z-axis Accelerometer", 


5 

//AccelerometerDemo 主 程序 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
sensorManager = (SensorManager)getSystemService(SENSOR_SERVICE); 
view = new MySurfaceView(this); 


setContentView(view); 
} 
@Override 
protected void onResume() { 
super.onResume(); 
List<Sensor> sensors = sensorManager.getSensorList(Sensor. TYPE ACCELEROMETER); 
if (sensors.size() > 0) { 
sensorManager.registerListener(this, sensors.get(0), SensorManager.SENSOR DELAY FASTEST); 
5 
} 
@Override 
protected void onPause() { 
super.onPause(); 
sensorManager.unregisterListener(this); 
} 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
} 


public void onSensorChanged(SensorEvent event) { 
view.onValueChanged(event.values); 


} 
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class MySurfaceView extends SurfaceView implements SurfaceHolder.Callback { 


paint); 


} 
HE3 


private Bitmap bitmap, curBitmap; 
private float x, y, Z; 
private int curWidth, curHeight; 
public MySurfaceView(Context context) { 
super(context); 
getHolder().addCallback(this); 
bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.android); 
} 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
X = (getWidth() - bitmap.getWidth()) / 2; 
y = (getHeight() - bitmap.getHeight()) / 2; 
onValueChanged(new float[3]); 


public void surfaceCreated(SurfaceHolder holder) { 


} 
public void surfaceDestroyed(SurfaceHolder holder) { 
} 
@SuppressWarnings("static-access") 
void onValueChanged(float[] values) { 
2 = 2 + values[2]/5; 
curWidth = (int) (bitmap.getWidth()* 2); 
curHeight = (int) (bitmap.getHeight()* 2); 
curBitmap = bitmap.createScaledBitmap(bitmap, curWidth, curHeight, false); 
x = (getWidth() - curWidth) / 2; 
y = (getHeight() - curHeight) / 2; 
x -= values[0]*10; 
y += values[1]*10; 
Canvas canvas = getHolder().lockCanvas(); 
if (canvas != null) { 
Paint paint = new Paint(); 
paint.setAntiAlias(true); 
paint.setColor(Color.BLUE); 
paint.setTextSize(24); 
canvas.drawColor(Color. WHITE); 
canvas.drawBitmap(curBitmap, x, y, null); 
for (int i = 0; i < values.length; i++) ( 
canvas.drawText(accelerometer[i] + ": " + values[i], 0, paint.getTextSize() * (і + 1), 


| 
getHolder().unlockCanvasAndPost(canvas); 


E Activity 界面 选择 Magnetic Field 选项 后 ， 会 执行 文件 MagneticFieldDemo.java 启动 磁场 传 


感 器 ， 有 具体 实现 代码 如 下 : 

public class MagneticFieldDemo extends Activity implements SensorEventListener { 
private SensorManager sensorManager; 
private MySurfaceView view; 
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private float тах; 
private Object[] magnetic = { 
"X-axis Maganetic Field", "Y-axis Maganetic Field","Z-axis Maganetic Field", 
Е 
//MagneticFieldDemo 主 程序 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
sensorManager = (SensorManager)getSystemService(SENSOR_SERVICE); 
view = new MySurfaceView(this); 


setContentView(view); 
} 
@Override 
protected void onResume() { 
super.onResume(); 
List<Sensor> sensors = sensorManager.getSensorList(Sensor.TYPE_MAGNETIC_FIELD); 
if (sensors.size() > 0) { 
Sensor sensor = sensors.get(0); 
max = sensor.getMaximumRange(); 
sensorManager.registerListener(this, sensor, SensorManager.SENSOR DELAY NORMAL); 
) 
} 
@Override 
protected void onPause() { 
super.onPause(); 


sensorManager.unregisterListener(this); 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 


public void onSensorChanged(SensorEvent event) { 
view.onValueChanged(event.values); 


class MySurfaceView extends SurfaceView implements SurfaceHolder.Callback { 
public MySurfaceView(Context context) { 
super(context); 
getHolder().addCallback(this); 


public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
onValueChanged(new float[3]); 
} 
public void surfaceCreated(SurfaceHolder holder) { 
} 
public void surfaceDestroyed(SurfaceHolder holder) { 
} 
void onValueChanged(float[] values) { 
Canvas canvas = getHolder().lockCanvas(); 
if (canvas != null) { 
Paint paint = new Paint(); 
paint.setAntiAlias(true); 
paint.setColor(Color.BLUE); 
paint.setTextSize(24); 
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} 


canvas.drawColor(Color.WHITE); 
for (int i = 0; i < values.length; i++) { 

canvas.drawText(magnetic[i] + ": " + values[i], 0, paint.getTextSize() * (i + 1), paint); 
} 
canvas.drawText("max: " + max, 0, paint.getTextSize() * 5, paint); 
getHolder().unlockCanvasAndPost(canvas); 


) 


MEE Activity 界面 选择 Orientation 选项 后 ， 会 执行 文件 OrientationDemo.java 启动 方向 传感器 ， 
具体 实现 代码 如 下 : 


public class OrientationDemo extends Activity implements SensorEventListener { 


private SensorManager sensorManager; 
private MySurfaceView view; 
private Object[] orientation = { 
“Rotate Z-axis Orientation", "Rotate X-axis Orientation","Rotate Y-axis Orientation", 


р 

//OrientationDemo 主 程序 

@Override 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
sensorManager = (SensorManager)getSystemService(SENSOR_SERVICE); 
view = new MySurfaceView(this); 


setContentView(view); 
} 
@Override 
protected void onResume() { 
super.onResume(); 
List<Sensor> sensors = sensorManager.getSensorList(Sensor.TYPE ORIENTATION); 
if (sensors.size() > 0) { 
sensorManager.registerListener(this, sensors.get(0), SensorManager.SENSOR DELAY NORMAL); 
} 
} 
@Override 
protected void onPause() { 
super.onPause(); 
sensorManager.unregisterListener(this); 
} 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
} 


public void onSensorChanged(SensorEvent event) { 
view.onValueChanged(event.values); 

} 

class MySurfaceView extends SurfaceView implements SurfaceHolder.Callback { 
private Bitmap bitmap, bitmap1, bitmap2,curBitmap; 
private float x, y, z; 
private float x1=130, y1=160; 
private int curWidth, curHeight; 
public MySurfaceView(Context context) { 
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super(context); 
getHolder().addCallback(this); 
bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.androidplate); 
bitmap1 = BitmapFactory.decodeResource(getResources(), R.drawable.androidheight); 
bitmap2 = BitmapFactory.decodeResource(getResources(), R.drawable.androidwidth); 
J 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) ( 
x = getWidth()/2; 
y = getHeight()/2; 
onValueChanged(new float[3]); 
n 
public void surfaceCreated(SurfaceHolder holder) ( 
) 
public void surfaceDestroyed(SurfaceHolder holder) ( 
} 
@SuppressWarnings("static-access") 
void onValueChangedf(float[] values) { 
Canvas canvas = getHolder().lockCanvas(); 
if (canvas != null) { 
Paint paint = new Paint(); 
paint.setAntiAlias(true); 
paint.setColor(Color.BLUE); 
paint.setTextSize(24); 
canvas.drawColor(Color. WHITE); 
canvas.save(); 
Matrix matrix = new Matrix(); 
curWidth = (int) (bitmap.getWidth()* 1); 
curHeight = (int) (bitmap.getHeight()* 1); 
curBitmap = bitmap.createScaledBitmap(bitmap, curWidth, curHeight, false); 
matrix.setRotate(-values[0], x , y ); 
canvas.setMatrix(matrix); 
canvas.drawBitmap(curBitmap, x-curWidth/2, y-curHeight/2, null); 
matrix.setRotate(values[1], x-x1 , y*y1 ); 
canvas.setMatrix(matrix); 
canvas.drawBitmap(bitmap1, x-x1-bitmap1.getWidth()/2, y*y1-bitmap1.getHeight()/2, null); 
matrix.setRotate(-values[2], x*x1 , y+y1 ); 
canvas.setMatrix(matrix); 
canvas.drawBitmap(bitmap2, x*x1-bitmap2.getWidth()/2, y*y1-bitmap2.getHeight()/2, null); 
canvas.restore(); 
for (int i 0; i < values.length; i++) ( 
canvas.drawText(orientation[i] + ":" + values[i], 0, paint.getTextSize() * (i + 1), paint); 


} 
getHolder().unlockCanvasAndPost(canvas); 
li 
} 
] 
) 
当 在 主 Activity 界面 选择 Temperature 选项 后 , 会 执行 文件 TemperatureDemo java 启动 温度 传感器 ， 
具体 实现 代码 如 下 : 


public class TemperatureDemo extends Activity implements SensorEventListener { 
private SensorManager sensorManager; 


© 
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private MySurfaceView view; 
private String vendor = "UNKNOWN"; 
private String name = "UNKNOWN"; 
private int version = 0; 
private Object[] temperature = { 
"Temperature", "No Data","No Data", 
Е 
//TemperatureDemo 主 程序 
@Override 
public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlnstanceState); 
sensorManager = (SensorManager)getSystemService(SENSOR SERVICE); 
view = new MySurfaceView(this); 
setContentView(view); 
} 
@Override 
protected void onResume() { 
super.onResume(); 
List<Sensor> sensors = sensorManager.getSensorList(Sensor. TYPE_TEMPERATURE); 
if (sensors.size() > 0) { 
Sensor sensor = sensors.get(0); 
vendor = sensor.getVendor(); 
name = sensor.getName(); 
version = sensor.getVersion(); 
sensorManager.registerListener(this, sensor, SensorManager.SENSOR DELAY NORMAL); 
} 
} 
@Override 
protected void onPause() { 
super.onPause(); 
sensorManager.unregisterListener(this); 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 


public void onSensorChanged(SensorEvent event) { 
view.onValueChanged(event.values); 


class MySurfaceView extends SurfaceView implements SurfaceHolder.Callback { 
public MySurfaceView(Context context) { 
super(context); 
getHolder().addCallback(this); 
} 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
onValueChanged(new float[3]); 
} 
public void surfaceCreated(SurfaceHolder holder) { 
} 
public void surfaceDestroyed(SurfaceHolder holder) { 
} 
void onValueChanged(float[] values) { 
Canvas canvas = getHolder().lockCanvas(); 


} 
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if (canvas != null) { 


Paint paint = new Paint(); 
paint.setAntiAlias(true); 
paint.setColor(Color.BLUE); 
paint.setTextSize(24); 
canvas.drawColor(Color.WHITE); 
for (int i = 0; i < values.length; i++) { 

canvas.drawText(temperature[i] + ":" + values[i], 0, paint.getTextSize() * (i + 1), paint); 
} 
canvas.drawText("Vender: "+vendor, 0, paint.getTextSize() * 5, paint); 
canvas.drawText("Name: "+name, 0, paint.getTextSize() * 6, paint); 
canvas.drawText("Version: "+ version, 0, paint.getTextSize() * 7, paint); 
getHolder().unlockCanvasAndPost(canvas); 


至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 11-2 所 示 。 


Compass 


Orientation 


Accelerometer 


Magnetic Field 


图 11-2 执行 效果 
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在 Android 物 联 网 设备 应 用 程序 开发 过 程 中 ， 经 常 需要 检测 设备 的 运动 数据 ， 例 如 设备 的 运动 速 
率 和 运动 距离 等 。 这 些 数据 对 于 健身 类 物 联网 设备 来 说 ， 都 是 十 分 重要 的 数据 ， 例 如 健身 手表 可 以 及 
时 测试 晨练 的 运动 距离 和 速率 。 在 Android 系统 中 ， 通 常 使 用 加 速度 传感器 、 线 性 加 速度 传感器 和 距 
离 传感器 来 检测 设备 的 运动 数据 。 本 章 将 详细 讲解 在 Android 物 联网 设备 中 使 用 加 速度 传感器 、 方 向 
传感器 和 陀螺 仪 传感器 的 方法 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 
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Фын 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 加 速度 传感器 详解 .avi 

在 现实 应 用 中 ， 加 速度 传感器 可 以 帮助 机 器 人 了 解 它 现在 身 处 的 环境 ， 能 够 分 辨 出 是 在 登山 ， 还 
是 在 下 山 ， 是 否 摔 倒 等 。 一 个 好 的 程序 员 能 够 使 用 加 速度 传感器 来 分 辨 出 上 述 情形 ， 加 速度 传感器 其 
至 可 以 用 来 分 析 发 动机 的 振动 。 本 节 将 简要 讲解 加 速度 传感器 的 基础 性 知识 。 


12.1.1 加 速度 传感器 的 分 类 


在 实际 应 用 过 程 中 ， 可 以 将 加 速度 传感器 分 为 如 下 所 示 的 4 类 。 

(1) 压 电 式 

压 电 式 加 速度 传感器 又 称 压 电 加 速度 计 。 它 也 属于 惯性 式 传感器 。 压 电 式 加 速度 传感器 的 原理 是 
利用 压 电 陶瓷 或 石英 晶体 的 压 电 效应 ， 在 加 速度 计 受 振 时 ， 质 量 块 加 在 压 电 元 件 上 的 力也 随 之 变化 。 
当 被 测 振动 频率 远 低 于 加 速度 计 的 固有 频率 时 ， 则 力 的 变化 与 被 测 加 速度 成 正比 。 

(2) 压 阻 式 

基于 世界 领先 的 MEMS 硅 微 加 工 技术 ， 压 阻 式 加 速度 传感器 具有 体积 小 、 低 功 耗 等 特点 ， 易 于 集 
成 在 各 种 模拟 和 数字 电路 中 ， 广 泛 应 用 于 汽车 碰撞 实验 、 测 试 仪 器 、 设 备 振动 监测 等 领域 。 加 速度 传 
感 器 网 为 客户 提供 压 阻 式 加 速度 传感器 / 压 阻 加 速度 计 各 品牌 的 型 号 、 参 数 、 原 理 、 价 格 、 接 线 图 等 
信息 。 

(3) 电容 式 

电容 式 加 速度 传感器 是 基于 电容 原理 的 极 距 变化 型 的 电容 传感器 。 电 容 式 加 速度 传感器 /电容 式 加 
速度 计 是 对 比较 通用 的 加 速度 传感器 。 在 某 些 领 域 无 可 替代 ， 如 安全 气囊 、 手 机 移动 设备 等 。 电 容 式 
加 速度 传感器 /电容 式 加 速度 计 采 用 了 微机 电 系统 (MEMS) 工艺 ， 在 大 量 生产 时 变 得 经 济 ， 从 而 保证 
了 较 低 的 成 本 。 
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(4) 伺服 式 

伺服 式 加 速度 传感器 是 一 种 闭环 测试 系统 ， 具 有 动态 性 能 好 、 动 态 范围 大 和 线性 度 好 等 特点 。 其 
工作 原理 ， 传 感 器 的 振动 系统 由 “m-k” 系 统 组 成 ， 与 一 般 加 速度 计 相 同 ， 但 质量 m 上 还 接着 一 个 电 
磁 线 圈 ， 当 基 座 上 有 加 速度 输入 时 ， 质 量 块 偏离 平衡 位 置 ， 该 位 移 大 小 由 位 移 传感器 检测 出 来 ， 经 伺 
服 放大 器 放大 后 转换 为 电流 输出 ， 该 电流 流 过 电磁 线圈 ， 在 永久 磁铁 的 磁场 中 产生 电磁 恢复 力 ， 力 图 
使 质量 块 保持 在 仪表 壳 体 中 原来 的 平衡 位 置 上 ， 所 以 伺服 加 速度 传感器 在 闭环 状态 下 工作 。 由 于 有 反 
馈 作用 ， 增 强 了 抗 干扰 的 能 力 ， 提 高 了 测量 精度 ， 扩 大 了 测量 范围 ， 伺 服 加 速度 测量 技术 广泛 地 应 
于 惯性 导航 和 惯性 制导 系统 中 ， 在 高 精度 的 振动 测量 和 标定 中 也 有 应 用 。 


12.1.2 ”加 速度 传感器 的 主要 应 用 领域 


在 计算 机 领域 中 ,加 速度 传感器 可 以 测量 牵引 力 产 生 的 加 速度 。 例 如 在 ІВМ Thinkpad 笔记 本 电脑 
中 就 内 置 了 加 速度 传感器 ， 能 够 动态 地 监测 出 笔记 本 在 使 用 中 的 振动 。 根 据 这 些 振动 数据 ， 系 统 会 智 
能 地 选择 关闭 硬盘 还 是 让 其 继续 运行 ， 这 样 可 以 最 大 程度 地 保护 里 面 的 数据 。 所 以 ， 加 速度 传感器 主 
要 应 用 在 手柄 振动 /摇晃 、 仪 器 仪表 、 汽 车 制 动 启动 、 地 震 、 报 警 系统 、 玩 具 、 结 构 物 、 环 境 监 视 、 工 
程 测 振 、 地 质 勘探 、 铁 路 、 桥 梁 、 大 坝 的 振动 测试 与 分 析 ， 还 有 和 鼠标， 高 层 建筑 结构 动态 特性 和 安全 
保卫 振动 侦察 上 。 下 面 将 详细 讲解 加 速度 传感器 的 主要 应 用 领域 。 

(1) 汽车 安全 

加 速度 传感器 主要 用 于 汽车 安全 气囊 、 防 抱 死 系统 、 牵 引 控制 系统 等 安全 性 能 方面 。 在 汽车 安全 
应 用 中 ， 加 速度 计 的 快速 反应 非常 重要 。 安 全 气囊 应 在 什么 时 候 弹出 要 迅速 确定 ， 所 以 加 速度 计 必 须 
在 瞬间 做 出 反应 。 通 过 采用 可 迅速 达到 稳定 状态 而 不 是 振动 不 止 的 传感器 设计 可 以 缩短 器 件 的 反应 时 
间 。 其 中 ， 压 阻 式 加 速度 传感器 由 于 在 汽车 工业 中 的 广泛 应 用 而 发 展 最 快 。 

(2) 游戏 控制 

加 速度 传感器 可 以 检测 上 下 左右 的 倾角 的 变化 ， 因 此 通过 前 后 倾斜 手持 设备 来 实现 对 游戏 中 物体 
的 前 后 左右 的 方向 控制 ， 就 变 得 很 简单 。 

(3) 图 像 自动 翻转 

用 加 速度 传感器 检测 手持 设备 的 旋转 动作 及 方向 ， 实 现 所 要 显示 图 像 的 转正 。 

(4) 电子 指南 针 倾 斜 校正 

磁 传 感 器 是 通过 测量 磁 通 量 的 大 小 来 确定 方向 的 。 当 磁 传感器 发 生 倾斜 时 ， 通 过 磁 传 感 器 的 地 磁 
通 量 将 发 生变 化 ， 从 而 使 方向 指向 产生 误差 。 因 此 ， 如 果 不 带 倾斜 校正 的 电子 指南 针 ， 需 要 用 户 水 平 
放置 。 而 利用 加 速度 传感器 可 以 测量 倾角 的 这 一 原理 ， 可 以 对 电子 指南 针 的 倾斜 进行 补偿 。 

(5) GPS 导航 系统 死角 的 补偿 

GPS 系统 是 通过 接收 三 颗 呈 120 度 分 布 的 卫星 信号 来 最 终 确定 物体 的 方位 的 。 在 一 些 特殊 的 场合 
和 地 貌 ， 如 隧道 、 高 楼 林立 、 从 林地 带 ，GPS 信号 会 变 弱 甚至 完全 失去 ， 这 也 就 是 所 谓 的 死角 。 而 通 
过 加 装 加 速度 传感器 及 以 前 我 们 所 通用 的 惯性 导航 ， 便 可 以 进行 系统 死 区 的 测量 。 对 加 速度 传感器 进 
行 一 次 积分 ， 就 变 成 了 单位 时 间 里 的 速度 变化 量 ， 从 而 测 出 在 死 区 内 物体 的 移动 。 

(6) 计 步 器 功能 

加 速度 传感器 可 以 检测 交流 信号 以 及 物体 的 振动 ， 人 在 走动 时 会 产生 一 定 规律 性 的 振动 ， 而 加 速 
度 传感器 可 以 检测 振动 的 过 零点 ， 从 而 计算 出 人 所 走 的 步 或 跑步 所 走 的 步 数 ， 从 而 计算 出 人 所 移动 的 
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位 移 。 并 且 利 用 一 定 的 公式 可 以 计算 出 卡路里 的 消耗 。 

Ст) 防 手 抖 功能 
用 加 速度 传感器 检测 手持 设备 的 振动 /晃动 幅度 ， 当 振动 /晃动 幅度 过 大 时 锁 住 照相 快门 ， 使 所 拍摄 
的 图 像 永 远 是 清晰 的 。 

(8) 闪 信 功能 

通过 挥动 手持 设备 实现 在 空中 显示 文字 ， 用 户 可 以 自己 编写 显示 的 文字 。 这 个 闪 信 功能 是 利用 人 
们 的 视觉 残留 现象 ， 用 加 速度 传感器 检测 挥动 的 周期 ， 实 现 所 显示 文字 的 准确 定位 。 

(9) 硬盘 保护 

利用 加 速度 传感器 检测 自由 落体 状态 ， 从 而 对 迷你 硬盘 实施 必要 的 保护 。 大 家 知道 ， 硬 盘 在 读 取 
数据 时 ， 磁 头 与 碟 片 之 间 的 间距 很 小 ， 因 此 ， 外 界 的 轻微 振动 就 会 对 硬盘 产生 很 坏 的 后 果 ， 使 数据 丢 
失 。 而 利用 加 速度 传感器 可 以 检测 自由 落体 状态 。 当 检测 到 自由 落体 状态 时 ， 让 磁头 复位 ， 以 减少 硬 
iR SERERE. 

(10) 设备 或 终端 姿态 检测 

加 速度 传感器 和 陀螺 仪 通常 称 为 惯性 传感器 ， 常 用 于 各 种 设备 或 终端 中 实现 姿态 检测 、 运 动 检测 
等 ， 也 就 很 适合 玩 体感 游戏 的 人 群 。 加 速度 传感器 利用 重力 加 速度 ， 可 以 用 于 检测 设备 的 倾斜 角度 ， 
但 是 它 会 受到 运动 加 速度 的 影响 ， 使 倾角 测量 不 够 准确 ， 所 以 通常 需 利用 陀螺 仪 和 磁 传 感 器 补偿 。 同 
时 磁 传 感 器 测量 方位 角 时 ， 也 是 利用 地 磁场 ， 当 系统 中 电流 变化 或 周围 有 导 磁 材料 时 ， 以 及 当 设 备 倾 
斜 时 ， 测 量 出 的 方位 角 也 不 准确 ， 这 时 需要 用 加 速度 传感器 〈 倾 角 传 感 器 ) 和 陀螺 仪 进行 补偿 。 

OD 智能 产品 

加 速度 传感器 在 微 信 功 能 中 的 创新 功能 突破 了 电子 产品 的 千 遍 一 律 ， 这 个 功能 的 实现 来 源 于 传 感 
器 的 方向 、 加 速 表 、 光 线 、 磁 场 、 临 近 性 、 温 度 等 参数 的 特性 。 这 个 原理 是 手机 里 面 集成 的 加 速度 传 
感 器 ， 它 能 够 分 别 测 量 X、Y、Z 3 个 方面 的 加 速度 值 ，X 方向 值 的 大 小 代表 手机 水 平移 动 ，Y 方向 值 
的 大 小 代表 手机 垂直 移动 ，Z 方向 值 的 大 小 代表 手机 的 空间 垂直 方向 ， 天 空 的 方向 为 正 ， 地 球 的 方向 
为 负 ， 然 后 把 相关 的 加 速度 值 传输 给 操作 系统 ， 通 过 判断 其 大 小 变化 ， 就 能 知道 同时 玩 微 信 的 朋友 。 


12.1.3 ”线性 加 速度 传感器 的 原理 


线性 加 速度 传感器 是 加 速度 传感器 的 一 种 ， 单 独 分 开讲 的 原因 是 为 了 和 螺旋 仪 传感器 分 开 。 陀 螺 
仪 是 测 角速度 的 ， 加 速度 是 测 线性 加 速度 的 。 其 中 前 者 利用 了 惯性 原理 ， 而 后 者 利用 了 力 平衡 原理 。 
线性 加 速度 传感器 利用 了 惯性 原理 : 

A( 加 速度 )=F( 惯 性 力 )M( 质 量 ) 

我 们 只 需要 测量 F 即 可 。 怎 么 测量 F? 只 要 用 电磁 力 去 平衡 这 个 力 就 可 以 得 到 F 对 应 于 电流 的 关 
系 ， 只 需要 用 实验 去 标定 这 个 比例 系数 就 行 了 。 多 数 加 速度 传感器 是 根据 压 电 效应 的 原理 来 工作 的 。 
所 谓 的 压 电 效应 就 是 “对 于 不 存在 对 称 中 心 的 异 极 晶 体 加 在 晶体 上 的 外 力 除了 使 晶体 发 生 形变 以 外 ， 
还 将 改变 晶体 的 极 化 状态 ， 在 晶体 内 部 建立 电场 ， 这 种 由 于 机 械 力 作用 使 介质 发 生 极 化 的 现象 称 为 正 
压 电 效应 ”。 

一 般 加 速度 传感器 就 是 利用 了 其 内 部 的 由 于 加 速度 造成 的 晶体 变形 这 个 特性 。 由 于 这 个 变形 会 产 
生 电 压 ， 只 要 计算 出 产生 电压 和 所 施加 的 加 速度 之 间 的 关系 ， 就 可 以 将 加 速度 转化 成 电压 输出 。 当 然 ， 
还 有 很 多 其 他 方法 来 制作 加 速度 传感器 ， 如 压 阻 技术 、 电 容 效应 、 热 气泡 效应 和 光 效 应 ， 但 是 其 最 基 
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本 的 原理 都 是 由 于 加 速度 产生 某 个 介质 产生 变形 ， 通 过 测量 其 变形 量 并 用 相关 电路 转化 成 电压 输出 。 
每 种 技术 都 有 各 自 的 机 会 和 问题 。 

压 阻 式 加 速度 传感器 由 于 在 汽车 工业 中 的 广泛 应 用 而 发 展 最 快 。 由 于 安全 性 越 来 越 成 为 汽车 制造 
商 的 卖点 ， 这 种 附加 系统 也 越 来 越 多 。 压 阻 式 加 速度 传感器 2000 年 的 市 场 规模 约 为 4.2 亿美 元 ， 根 据 
有 关 调 查 ， 预 计 其 市 值 将 按 年 平均 4.1% 的 速度 增长 ， 至 2007 年 达到 5.6 亿美 元 。 这 其 中 ， 欧 洲 市 场 的 
速度 最 快 ， 因 为 欧洲 是 许多 安全 气囊 和 汽车 生产 企业 的 所 在 地 。 

压 电 技 术 主要 在 工业 上 用 来 防止 机 器 故障 ， 使 用 这 种 传感器 可 以 检测 机 器 潜在 的 故障 以 达到 自 保 
护 ， 以 及 避免 对 工人 产生 意外 伤害 ， 这 种 传感器 具有 用 户 ， 尤 其 是 质量 行业 的 用 户 所 追求 的 可 重复 性 、 
稳定 性 和 自生 性 。 但 是 在 许多 新 的 应 用 领域 ， 很 多 用 户 尚 无 使 用 这 类 传感器 的 意识 ， 销 售 商 冒险 进入 
这 种 尚 待 开发 的 市 场 会 麻烦 很 多 ， 因 为 终端 用 户 对 由 于 使 用 这 种 传感器 而 带 来 的 问题 和 解决 方法 都 认 
识 不 多 。 如 果 这 些 问 题 能 够 得 到 解决 ， 将 会 促进 压 电 传感器 得 到 更 快 的 发 展 。2002 年 压 电 传感器 市 值 
为 3 亿美 元 ， 预 计 其 年 增长 率 将 达到 4.9%， 到 2007 年 达到 4.2 亿美 元 。 

使 用 加 速度 传感器 有 时 会 碰 到 低频 场合 测量 时 输出 信号 出 现 失真 的 情况 ， 用 多 种 测量 判断 方法 一 
时 找 不 出 故障 出 现 的 原因 ， 经 过 分 析 总 结 ， 导 致 测量 结果 失真 的 因素 主要 是 : 系统 低频 响应 差 ， 系 统 
低频 信 品 比 差 ， 外 界 环境 对 测量 信号 的 影响 。 所 以 ， 只 要 出 现 加 速度 传感器 低频 测量 信号 失真 情况 
对 比 以 上 3 点 查看 是 哪个 因素 造成 的 ， 有 针对 性 地 进行 解决 。 

在 Android 系统 中 ,线性 加 速度 传感器 的 类 型 是 TYPE_LINEAR ACCELERATION, 单位 是 ms? , 
能 够 获取 加 速度 传感器 去 除 重力 的 影响 得 到 的 数据 。 


12.1.4 Android 系统 中 的 加 速度 传感器 


在 Android 系统 中 ， 加 速度 传感器 是 TYPE_ACCELEROMETER， 单 位 是 m/s* ， 能 够 测量 应 用 于 
W X. Y. Z 轴 上 的 加 速度 ， 又 叫做 G-sensor。 在 开发 过 程 中 ， 通 过 Android 的 加 速度 传感器 可 以 取 
fX. Y. Z 3 个 轴 的 加 速度 。 在 Android 系统 中 ， 在 类 SensorManager 中 定义 了 很 多 星体 的 重力 加 速 
度 值 ， 如 表 12-1 所 示 。 


表 12-1 类 SensorManager 被 定义 的 各 新 星体 的 重力 加 速度 值 


в ш 名 实际 的 值 
GRAVITY DEATH STAR 1 3.5303614E-7 
GRAVITY EARTH 9.80665 
GRAVITY_JUPITER 23.12 
GRAVITY MARS 3.71 
GRAVITY MERCURY 37 
GRAVITY MOON 16 
GRAVITY NEPTUNE 12.0 
GRAVITY PLUTO 0.6 
GRAVITY SATURN 8.96 
GRAVITY SUN 2750 
GRAVITY THE ISLAND 4.815162 
GRAVITY URANUS 8.69 
GRAVITY_VENUS 8.87 
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通常 来 说 ， 从 加 速度 传感器 获取 的 值 ， 拿 手机 等 智能 设备 的 人 的 手 振动 或 放 在 摇晃 的 场所 时 ， 受 
振动 影响 设备 的 值 增 幅 变 化 是 存在 的 。 手 的 摇动 、 轻 微 振动 的 影响 属于 长 波形 式 ， 去 掉 这 种 长 波 干扰 
的 影响 ， 可 以 取得 高 精度 的 值 。 去 掉 这 种 长 波 ， 这 种 过 滤 机 叫 Low-Pass Filter。Low-Pass Filter 机 制 有 
如 下 所 示 的 3 种 封装 方法 。 

从 抽样 数据 中 取得 中 间 的 值 的 方法 。 

最 近 取 得 的 加 速度 的 值 每 个 很 少 变 化 的 方法 。 

从 抽样 数据 中 取得 中 间 的 值 的 方法 。 

在 Android 应 用 中 ， 有 时 需要 获取 瞬间 加 速度 值 ， 例 如 类 似 计 步 器 、 作 用 力 测定 的 应 用 开发 时 ， 
如 果 想 检测 出 加 速度 急剧 的 变化 。 此 时 的 处 理 和 Low-Pass Filter 处 理 相反 ， 需 要 去 掉 短 周波 的 影响 ， 
这 样 可 以 取得 数据 。 像 这 种 去 掉 短 周波 的 影响 的 过 滤器 叫做 High-Pass Filter。 


12.1.5 ”实战 演练 一 一 获取 X, Y. Z 轴 的 加 速度 值 
本 实例 将 演示 在 Android 中 使 用 加 速度 传感器 的 方法 。 


本 实例 的 具体 实现 流程 如 下 所 示 。 
(1) 编写 布局 文件 main.xml， 主 要 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> < 上 -声明 xml 的 版 本 以 及 编码 格式 --> 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout, height-"fill parent" <!-- 添 加 一 个 垂直 的 线性 布局 --> 
<TextView 
android:id="@+id/title" 
android:gravity="center_horizontal" 
android:textSize="20px" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text="@string/title"/> <!-Җй—1° TextView 控件 --> 
<TextView 
android:id="@+id/myTextView1" 
android:textSize="1 8px" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text-"QstringlmyTextView1l"/» ”<!-- 添 加 一 个 TextView 控件 --> 
<TextView 
android:id="@+id/myTextView2" 
android:textSize="18px" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView2"/> ”<!-- 添 加 一 个 TextView 控件 --> 
<TextView 


android:id="@+id/myTextView3" 
e. 
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android:textSize="18px" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView3"/> <l- 添加 一 个 TextView 控件 --> 
</LinearLayout> 
(2) 编写 主 程序 文件 jiaSLILjava， 此 文件 的 具体 实现 流程 如 下 : 
声明 3 个 TextView 的 引用 ， 分 别 用 来 显示 3 个 方向 上 的 加 速度 。 
声明 对 SensorManager 对 象 的 引用 ， 此 处 因 使 用 的 是 SensorSimulator 工具 来 模拟 传感器 。 
设置 当前 的 用 户 界面 ， 然 后 得 到 XML 文件 中 配置 的 各 个 控件 的 引用 。 
初始 化 SensorManager 对 象 ， 同 样 因 为 调试 的 原因 用 专用 代码 替代 。 
初始 化 监听 器 类 ， 并 重 写 了 该 类 中 的 两 个 方法 。 
在 onSensorChanged 方法 中 只 处 理 加 速度 的 变化 ， 并 将 得 到 的 数值 显示 到 TextView 中 。 
重 写 类 Activity 的 onResume 方 法 ,在 该 方法 中 为 SensorManager 添 加 监听 ,还 需要 重 写 onPause 
方法 ， 在 该 方法 中 取消 注册 的 监听 器 。 
文件 jiaSLLjava 的 主要 实现 代码 如 下 : 
public class jiaSCH extends Activity { 
TextView myTextView1 ;//x 方向 加 速度 
TextView myTextView2;//y 方向 加 速度 
TextView myTextView3;//z 方向 加 速度 
//SensorManager mySensorManager;//SensorManager 对 象 引 用 
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SensorManagerSimulator mySensorManager; // 声 明 SensorManagerSimulator 对 象 ， 调 试 时 用 
@Override 
public void onCreate(Bundle savedinstanceState) { // 重 写 onCreate() 方 法 


super.onCreate(savedInstanceState); 
setContentView(R.layout.main);// 设 置 当前 的 用 户 界面 
myTextView1 = (TextView) findViewByld(R.id.myTextView1); /得 到 myTextView1 引用 
myTextView2 = (TextView) findViewByld(R.id.myTextView2); 。 // 得 到 myTextView2 引用 
myTextView3 = (TextView) findViewByld(R.id.myTextView3); 。 // 得 到 myTextView3 引用 
/调试 时 用 
mySensorManager = SensorManagerSimulator.getSystemService(this, SENSOR_SERVICE); 
mySensorManager.connectSimulator(); /连接 Simulator 服务 器 
private SensorListener mySensorListener = new SensorListener(){ 
@Override 
public void onAccuracyChanged(int sensor, int accuracy) {} /| 重 写 onAccuracyChanged() 方 法 
@Override 
public void onSensorChanged(int sensor, float[] values) { // 重 写 onSensorChanged() 方 法 
if(sensor == SensorManager.SENSOR_ACCELEROMETER){/ 只 检查 加 速度 的 变化 
myTextView1.setText("x 方向 上 的 加 速度 为 : "+values[0]);// 将 提取 的 x 数据 显示 到 TextView 
myTextView2.setText("y 方向 上 的 加 速度 为 : "+values[1]);// 将 提取 的 у 数据 显示 到 TextView 
myTextView3.setText("z 方向 上 的 加 速度 为 : "+values[2]);// 将 提取 的 z 数据 显示 到 TextView 


} 
k 
(QOverride 
protected void onResume() ( 11% onResume()75;& 

mySensorManager.registerl istener( /注册 监听 

mySensorListener, /监听 SensorListener 对 象 


© 


DU Android we ae ACA 1813 8 


SensorManager.SENSOR ACCELEROMETER, /设置 传感器 的 类 型 为 加 速度 
SensorManager.SENSOR DELAY UI /用 传感器 事件 传递 频 度 
J 
super.onResume(); 
} 
@Override 
protected void onPause() { 11% onPause()75;& 
mySensorManager.unregisterListener(mySensorListener); // 取 消 注册 监听 器 
super.onPause(); 
} 


} 
(3) 为 了 调试 本 实例 代码 ， 需 要 为 该 程序 添加 网 络 权 限 ， 因 为 SensorSimulator 安装 在 Android fi 
拟 器 中 的 客户 端 ， 需 要 和 桌面 端的 服务 器 进行 通信 。 


12.1.6 ”实战 演练 一 实现 仿 微 信 “ 摇 一 摇 ” 效 果 
本 实例 的 功能 是 实现 仿 微 信 的 “ 扬 一 扬 ” 效 果 。 


本 实例 的 布局 文件 是 shake.xml, 在 界面 上 方 设置 了 一 个 图 片 , 在 下 方 设置 了 按钮 控件 和 文本 控件 ， 
具体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical" > 


«RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout centerInParent-"true" > 


«ImageView 
android:id="@+id/shakeBg" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 
android:src-"(odrawable/shake all" /> 


<LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout centerInParent-"true" 
android:orientation-" vertical" > 


«RelativeLayout 


android:id="@+id/shakelmgUp" 
android:layout_width="fill_parent" 
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android:layout_height="190dp" 
android:background="#111111"> 
«ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout centerHorizontal-"true" 
android:src-"(Qdrawable/shake up" 
I 
</RelativeLayout> 
<RelativeLayout 
android:id="@+id/shakelmgDown" 
android:layout_width="fill_parent" 
android:layout_height="190dp" 
android:background="#111111"> 
<ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
android:src-"(drawable/shake down" 
I 
</RelativeLayout> 
</LinearLayout> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/shake_title_bar" 
android:layout_width="fill_parent" 
android:layout_height="45dp" 
android:background="@drawable/title_bar" 
android:gravity="center_vertical" > 
<Button 
android:layout_width="70dp" 
android:layout_height="wrap_content" 
android:layout_centerVertical="true" 
android:text-"j& [s]" 
android:textSize="14sp" 
android:textColor="#fff" 
android:onClick="shake_activity_back" 
android:background="@drawable/title_btn_back"/> 
<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" f —1&" 
android:layout_centerinParent="true" 
android:textSize="20sp" 
android:textColor="#ffffff" /> 
<ImageButton 
android:layout_width="67dp" 
android:layout_height="wrap_content" 
android:layout alignParentRight-"true" 
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android:layout centerVertical-"true" 
android:layout marginRight-"5dp" 
android:src-"(drawable/mm title btn menu" 
android:background="@drawable/title_btn_right" 
android:onClick-"linshi" 
> 
</RelativeLayout> 


<SlidingDrawer 
android:id="@+id/slidingDrawer1" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:content="@+id/content" 
android:handle="@+id/handle" > 
<Button 
android:id="@+id/handle" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android:background-"(Qdrawable/shake report dragger up" /> 
«LinearLayout 
android:id="@+id/content" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:background="#f9f9f9" > 
<ImageView 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:scaleType-"fitX Y" 
android:src-"(Qdrawable/shake line up" /> 
</LinearLayout> 
</SlidingDrawer> 
</LinearLayout> 


程序 文件 shakeActivity.java 实现 了 主 Activity， 核 心 功能 是 监听 设备 的 摇动 方向 ， 定 义 了 摇 一 摇动 
画 ， 并 设置 摇动 过 程 中 的 振动 效果 。 文 件 shakeActivity.java 的 主要 实现 代码 如 下 : 
public class shakeActivity extends Activity{ 


ShakeListener mShakeListener = null; 
Vibrator mVibrator; 

private RelativeLayout mlmgUp; 
private RelativeLayout mlmgDn; 
private RelativeLayout mTitle; 


private SlidingDrawer mDrawer; 
private Button mDrawerBtn; 


(QOverride 
public void onCreate(Bundle savedinstanceState) { 


super.onCreate(savedinstanceState); 
e. 
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setContentView(R.layout.shake); 
IIdrawerSet ();// 设 置 drawer 监听 切换 按钮 的 方向 


mVibrator = (Vibrator)getApplication().getSystemService(VIBRATOR SERVICE); 


mlmgUp = (RelativeLayout) findViewByld(R.id.shakelmgUp); 
mlmgDn = (RelativeLayout) findViewByld(R.id.shakelmgDown); 
mTitle = (RelativeLayout) findViewByld(R.id.shake_title_bar); 


mDrawer = (SlidingDrawer) findViewByld(R.id.slidingDrawer1); 
mDrawerBtn = (Button) findViewByld(R.id.handle); 
mDrawer.setOnDrawerOpenListener(new OnDrawerOpenListener() 
( public void onDrawerOpened() 


{ 


mDrawerBtn.setBackgroundDrawable(getResources().getDrawable(R.drawable.shake_down)); 
TranslateAnimation titleup = new TranslateAnimation(Animation. RELATIVE_TO_SELF, 
Of,Animation.RELATIVE_TO_SELF  0f,Animation.RELATIVE_TO_SELF,0f,Animation.RELATIVE_TO_SELF.-1.0f); 
titleup.setDuration(200); 
titleup.setFillAfter(true); 
mTitle.startAnimation(titleup); 


} 


}); 

MZ SlidingDrawer 被 关闭 的 事件 处 理 */ 
mDrawer.setOnDrawerCloseListener(new OnDrawerCloseListener() 
{ public void onDrawerClosed() 


{ 


mDrawerBtn.setBackgroundDrawable(getResources().getDrawable(R.drawable.shake_report_dragger_up)); 
TranslateAnimation titledn = new TranslateAnimation(Animation.RELATIVE_TO_SELF,Of, 
Animation.RELATIVE TO SELF,0f,Animation.RELATIVE TO SELF,-1.0f,Animation.RELATIVE TO SELF,0f); 
titledn.setDuration(200); 
titledn.setFillAfter(false); 
mTitle.startAnimation(titledn); 


» 


mShakeListener = new ShakeListener(this); 
mShakeListener.setOnShakeListener(new OnShakeListener() ( 
public void onShake() { 
I[Toast.makeText(getApplicationContext(), " 抱 欢 ， 暂 时 没有 找到 在 同一 时 刻 摇 一 摇 的 人 。\ 
再 试 一 次 吧 ! " ToastLENGTH_SHORT).show(); 
startAnim(); /开始 摇 一 摇 手 掌 动 画 
mShakeListener.stop(); 
startVibrato(); /开始 振动 
new Handler().postDelayed(new Runnable(){ 
@Override 
public void run(){ 
/Toast.makeText(getApplicationContext(), " 抱 鞭 ， 暂 时 没有 找到 \n 在 同一 时 刻 摇 
一 摇 的 人 。\n 再 试 一 次 吧 ! ", 500).setGravity(Gravity.CENTER,0,0).show(); 
Toast mtoast; 
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mtoast = Toast.makeText(getApplicationContext(), 
"OR, 暂时 没有 找到 \n 在 同一 时 刻 摇 一 摇 的 人 。\n 再 试 一 次 吧 ! ", 10); 
//mtoast.setGravity(Gravity.CENTER, 0, 0); 


mtoast.show(); 
mVibrator.cancel(); 
mShakeListener.start(); 
} 
}, 2000); 


D 
) 


public void startAnim () ( /定义 摇 一 摇动 画 

AnimationSet animup = new AnimationSet(true); 

TranslateAnimation mytranslateanimupO = new TranslateAnimation(Animation.RELATIVE TO - 
SELF,O0f,Animation.RELATIVE TO SELF,O0f,Animation.RELATIVE TO SELF,0f,Animation.RELATIVE TO SE 
LF,-0.5f); 

mytranslateanimup0.setDuration(1000); 

TranslateAnimation mytranslateanimup1 = new TranslateAnimation(Animation.RELATIVE TO SELF, 
Of,Animation.RELATIVE TO SELF,Of,Animation.RELATIVE TO SELF.0f,Animation.RELATIVE TO  SELF,*0.5f); 

mytranslateanimup1.setDuration(1000); 

mytranslateanimup1.setStartOffset(1000); 

animup.addAnimation(mytranslateanimupO); 

animup.addAnimation(mytranslateanimup!1 ); 

mlimgUp.startAnimation(animup); 


AnimationSet animdn = new AnimationSet(true); 

TranslateAnimation mytranslateanimdn0 = new TranslateAnimation(Animation.RELATIVE TO SELF, 
Of,Animation.RELATIVE TO SELF,Of,Animation.RELATIVE TO SELF,0f,Animation.RELATIVE TO. SELF,*0.5f); 

mytranslateanimdnO.setDuration(1000); 

TranslateAnimation mytranslateanimdn1 = new TranslateAnimation(Animation.RELATIVE TO SELF, 
Of,Animation.RELATIVE TO SELF,O0f,Animation.RELATIVE TO SELF.0f,Animation.RELATIVE TO SELF.-0.5f); 

mytranslateanimdn1.setDuration(1000); 

mytranslateanimdn1.setStartOffset(1000); 

animdn.addAnimation(mytranslateanimdnO); 

animdn.addAnimation(mytranslateanimdn1); 

mimgDn.startAnimation(animdn); 


) 
public void startVibrato()( /定义 振动 
mVibrator.vibrate( new long[](500,200,500,200), -1); /第 一 个 { } 里 面 是 节奏 数组 ， 第 二 个 参数 是 重复 
次 数 ，-1 为 不 重复 ， 非 -1 为 从 pattern 的 指定 下 标 开始 重复 


public void shake_activity_back(View v) { // 标 题 栏 返回 按钮 
this.finish(); 


} 
public void linshi(View v) { /标题 栏 
startAnim(); 
} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
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if (mShakeListener != null) { 
mShakeListener.stop(); 
1 
) 

) 

上 述 代 码 实现 了 与 设备 的 交互 控制 一 一 振动 ， 振 动 是 一 种 提醒 或 蔡 换 铃声 的 事件 ， 通 过 上 述 代码 
可 以 了 解 到 如 何 触发 手机 振动 事件 ， 虽 然 振动 是 手机 默认 的 模式 ， 但 通过 程序 的 辅助 ， 可 以 做 更 精密 
的 控制 ， 诸 如 振动 周期 、 持 续 时 间 等 。 在 设置 振动 (Vibration) 事件 中 ， 必 须要 知道 命令 其 振动 的 时 间 
长 短 、 振 动 事件 的 周期 等 。 而 在 Android 中 设置 的 数值 都 是 以 毫秒 〈1000 毫秒 =1 秒 ) 来 做 计算 的 ， 所 
以 在 做 设置 时 需要 注意 ， 如 果 设 置 的 时 间 值 太 小 ， 会 感觉 不 出 来 。 要 想 让 设备 振动 ， 需 创建 Vibrator 
对 象 ， 通 过 调用 vibrate 方法 来 达到 振动 的 目的 ， 在 Vibrator 的 构造 器 中 有 4 个 参数 ， 前 3 个 的 值 是 设 
置 振动 的 大 小 ， 在 这 里 可 以 把 数值 改 成 一 大 一 小 ， 这 样 就 可 以 明显 地 感觉 出 振动 的 差异 ， 而 最 后 一 个 
值 是 设置 振动 的 时 间 。 

程序 文件 ShakeListener.java 的 功能 是 为 设备 实现 了 一 个 设备 摇晃 的 监听 器 ， 这 一 功能 是 通过 传 感 
器 实现 的 。 文 件 ShakeListener.java 的 主要 实现 代码 如 下 : 

public class ShakeListener implements SensorEventListener { 

// 速 度 阐 值 ， 当 摇晃 速度 达到 这 个 值 后 产生 作用 
private static final int SPEED_SHRESHOLD = 3000; 
/两 次 检测 的 时 间 间 隔 

private static final int UPTATE_INTERVAL_TIME = 70; 
/传感器 管理 器 

private SensorManager sensorManager; 

/传感器 

private Sensor sensor; 

// 重 力 感应 监听 器 

private OnShakeListener onShakeListener; 

ПЕТ 

private Context mContext; 

// 手 机 上 一 个 位 置 时 重力 感应 坐标 

private float lastX; 

private float lastY; 

private float lastZ; 

// 上 次 检测 时 间 

private long lastUpdateTime; 


// 构 造 器 

public ShakeListener(Context с) { 
/获得 监听 对 象 
mContext = с; 
start(); 

} 


/开始 
public void start() { 
// 获 得 传感器 管理 器 
sensorManager = (SensorManager) mContext 
.getSystemService(Context. SENSOR_SERVICE); 
if (sensorManager != null) { 
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// 获 得 重力 传感器 

sensor = sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER); 
} 
/注册 


if (Sensor != null) { 
sensorManager.registerListener(this, sensor, 
SensorManager.SENSOR_DELAY_GAME); 


} 


/停止 检测 
public void stop(){ 
sensorManager.unregisterListener(this); 


} 


// 设 置 重 力 感应 监听 器 
public void setOnShakeListener(OnShakeListener listener) { 
onShakeListener = listener; 


} 


/重力 感应 器 感应 获得 变化 数据 
public void onSensorChanged(SensorEvent event) { 
// 现 在 检测 时 间 
long currentUpdateTime = System.currentTimeMillis(); 
// 两 次 检测 的 时 间 间 隔 
long timelnterval = currentUpdateTime - lastUpdateTime; 
// 判 断 是 否 达到 了 检测 时 间 间 隔 
if (timelnterval < UPTATE_INTERVAL_TIME) 
return; 
// 现 在 的 时 间 变 成 last 时 间 
lastUpdateTime = currentUpdateTime; 


// 获 得 x,y,z 坐标 

float x = event.values[0]; 
float у = event.values[1]; 
float z = event.values[2]; 


// 获 得 x,y,z 的 变化 值 

float deltaX = x - lastX; 
float deltaY = y - lastY; 
float deltaZ = z - lastZ; 


/将 现在 的 坐标 变 成 last 坐标 
lastX =х; 
lastY = y; 
lastZ = z; 


double speed = Math.sqrt(deltaX * deltaX + deltaY * deltaY + deltaZ 


* deltaZ) 
/ timelnterval * 10000; 
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// 达 到 速度 阅 值 ， 发 出 提示 
if (speed >= SPEED_SHRESHOLD) { 
onShakeListener.onShake(); 
} 
} 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 


} 


/摇晃 监听 接口 

public interface OnShakeListener { 
public void onShake(); 

} 


} 
在 真 机 中 执行 后 将 会 实现 和 微 信 “ 摇 一 摇 ” 类 似 的 效果 ， 如 图 12-1 所 示 。 


图 12-1 “ 摇 一 摇 ” 效 果 


122 方向 传感器 详解 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 方 向 传感器 详解 .avi 

在 Android 设备 中 ， 经 常 需要 检测 设备 的 方向 ， 例 如 设备 的 朝向 和 移动 方向 。 在 Android 系统 中 ， 
通常 使 用 重力 传感器 、 加 速度 传感器 、 磁 场 传感器 和 旋转 矢量 传感器 来 检测 设备 的 方向 。 本 节 将 详细 
讲解 在 Android 设备 中 使 用 方向 传感器 检测 设备 方向 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 
下 基础 。 


12.2.1 方向 传感器 基础 


在 现实 世界 中 ， 方 向 传感器 通过 对 力 敏感 的 传感器 ， 感 受 手机 等 设备 在 变换 姿势 时 的 重心 变化 ， 
使 手机 等 设备 光标 变化 位 置 ， 从 而 实现 选择 的 功能 。 方 向 传感器 运用 了 欧 拉 角 的 知识 ， 欧 拉 角 的 基本 


Была 


思想 是 将 角 位 移 分 解 为 绕 3 个 互相 垂直 轴 的 3 个 旋转 组 成 的 序列 。 其 实 ， 任 意 3 个 轴 和 任意 顺序 都 可 
以 ， 但 最 有 意义 的 是 使 用 笛 卡 儿 坐标 系 并 按 一 定 的 顺序 所 组 成 的 旋转 序列 。 

在 学 习 欧 拉 角 知 识 之 前 先 介绍 几 种 不 同 概念 的 坐标 系 ， 以 便于 读者 理解 欧 拉 角 知识 。 

(1) 世界 坐标 系 

世界 坐标 系 是 一 个 特殊 的 坐标 系 ， 建 立 了 描述 其 他 坐标 系 所 需要 的 参考 框架 。 能 够 用 世界 坐标 系 
描述 其 他 坐标 系 的 位 置 ， 而 不 能 用 更 大 的 、 外 部 的 坐标 系 来 描述 世界 坐标 系 。 例 如 ,“ 向 西 >“ 向 东 ” 
等 词汇 就 是 世界 坐标 系 中 的 描述 词汇 。 

(2) 物体 坐标 系 

物体 坐标 系 是 和 特定 物体 相关 联 的 坐标 系 ， 每 个 物体 都 有 它们 独立 的 坐标 系 。 当 物体 移动 或 改变 
方向 时 ， 和 该 物体 相关 联 的 坐标 系 将 随 之 移动 或 改变 方向 。 例 如 ,“ 向 左 ?“ 向 右 ” 等 词汇 就 是 物体 坐 
标 系 中 的 描述 词汇 。 

(з) 摄像 机 坐标 系 

摄像 机 坐标 系 是 和 观察 者 密切 相关 的 坐标 系 。 在 摄像 机 坐标 系 中 ， 摄 像 机 在 原点 ，x 轴 向 右 ，z #H 

向 前 (朝向 屏幕 内 或 摄像 机 方向 )，y 轴 向 上 〈 不 是 世界 的 上 方 而 是 摄像 机 本 身 的 上 方 )。 
(4) 惯性 坐标 系 

惯性 坐标 系 是 为 了 简化 世界 坐标 系 到 物体 坐标 系 的 转换 而 引入 的 一 种 新 的 坐标 系 。 惯 性 坐标 系 的 
原点 和 物体 坐标 系 的 原点 重合 ， 但 惯性 坐标 系 的 轴 平 行 于 世界 坐标 系 的 轴 。 

在 欧 拉 角 中 ， 表 示 一 个 物体 的 方位 用 “Yaw-Pitch-Roll” 约 定 。 在 这 个 系统 中 ， 一 个 方位 被 定义 为 
— Yaw 角 、 一 个 Pitch 角 和 一 个 Ron 角 。 欧 拉 角 的 基本 思想 是 让 物体 开始 于 “标准 ”方位 ， 目 的 是 
使 物体 坐标 轴 和 惯性 坐标 轴 对 齐 。 在 标准 方位 上 ， 让 物体 做 Yaw. Pitch 和 Roll 旋转 ， 最 后 物体 到 达 我 
们 想 要 描述 的 方位 。 

(5) Yaw 轴 

Yaw 轴 是 3 个 方向 轴 中 唯一 不 变 的 轴 ， 其 方向 总 是 竖 直 向 上 ， 和 世界 坐标 系 中 的 Z 轴 是 等 同 的 ， 

也 就 是 重力 加 速度 g 的 反方 向 。 
(6) Pitch 轴 

Pitch 轴 方向 依赖 于 手机 沿 Yaw 轴 的 转动 情况 ， 即 当 手 机 沿 Yaw 转 过 一 定 的 角度 后 ，Pitch 轴 也 相 
应 围绕 Yaw 轴 转 动 相同 的 角度 。Pitch 轴 的 位 置 依赖 于 手机 沿 Yaw 轴 转 过 的 角度 ， 好 比 Yaw 轴 和 Pitch 
轴 是 两 根 焊 死 在 一 起 成 90。 


12.2.2 Android 中 的 方向 传感器 
在 Android 系统 中 , 方向 传感器 的 类 型 是 TYPE_ORIENTATION, д 
用 于 测量 设备 围绕 3 个 物理 轴 (xyz) 的 旋转 角度 ， 在 新 版 本 中 已 经 so， -~ x 
使 用 SensorManager.getOrientation() 蔡 代 。Android 系统 中 的 方向 传 感 б d 
器 在 生活 中 的 典型 应 用 例子 是 指南 针 , 接 下 来 先 来 简单 介绍 一 下 传 感 / 


器 中 3 个 参数 X、Y、Z 的 含义 ， 如 图 12-2 所 示 。 

如 图 12-2 所 示 ， 绿 色 部 分 表示 一 个 手机 ， 带 有 小 圈 那 一 头 是 手 
机 头 部 ， 各 个 部 分 的 具体 说 明 如 下 所 示 。 

传感器 中 的 X: 如 图 12-2 所 示 ， 规 定 X 正 半 轴 为 北 ， 手 机 


e. 
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头 部 指向 OF 方向 ,， 此 时 X 的 值 为 0。 如 果 手 机 头 部 指向 OG 方向 ， 此 时 X 值 为 90, 指向 OH 
方向 ，X 值 为 180， 指 向 OE，X 值 为 270。 
传感器 中 的 v: 现在 将 手机 沿 着 BC 轴 慢 慢 向 上 抬 起 ， 即 手机 头 部 不 动 ， 尾 部 慢 慢 向 上 狂 起 
来 ， 直 到 AD 跑 到 BC 右边 并 落 在 XOY 平面 上 ，Y 的 值 将 从 0 一 180 之 间 变 动 ， 如 果 手 机 党 
着 AD 轴 慢 慢 向 上 抬 起 ， 即 手机 尾部 不 动 ， 直 到 BC 跑 到 AD 左边 并 且 落 在 XOY 平面 上 ，Y 
的 值 将 从 0 一 -180 之 间 变 动 ， 这 就 是 方向 传感器 中 六 的 含义 。 
传感器 中 的 Z: 现在 将 手机 沿 着 AB 轴 慢 慢 向 上 抬 起 ， 即 手机 左边 框 不 动 ， 右 边框 慢 慢 向 上 撼 
起 来 ， 直 到 CD HF) AB 右边 并 落 在 XOY 平面 上 ，Z 的 值 将 从 0 一 180 之 间 变 动 ， 如 果 手 机 
沿 着 CD 轴 慢 慢 向 上 抬 起 , 即 手机 右边 框 不 动 , 直到 AB 跑 到 CD 左边 并 且 落 在 XOY 平面 上 ， 
Z 的 值 将 从 0 一 -180 之 间 变 动 ， 这 就 是 方向 传感器 中 Z 的 含义 。 
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本 实例 将 演示 在 Android 中 使 用 方向 传感器 的 方法 。 


[a] 


(1) 实现 布局 文件 
编写 布局 文件 main.xml， 主 要 代码 如 下 : 
<TextView 
android:id="@+id/title" 
android:gravity="center_horizontal" 
android:textSize="20px" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/title"/><!— 添加 一 个 TextView 控件 —> 
<TextView 
android:id="@+id/myTextView1" 
android:textSize="18px" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView1"/><!-- 添加 一 个 TextView 控件 —> 
<TextView 
android:id="@+id/myTextView2" 
android:textSize="18px" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView2"/><!-- 添加 一 个 TextView 控件 —> 
<TextView 
android:id="@+id/myTextView3" 
android:textSize="18px" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView3"/><!- 添加 一 个 TextView 控件 — 
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(2) 实现 主 程序 文件 
编写 主 程序 文件 zitaiLlLjava， 此 文件 的 具体 实现 流程 如 下 所 示 。 
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声明 3 个 分 别 用 来 显示 Yaw, Pitch, Roll 的 TextView 的 引用 。 

声明 SensorManager 引用 ， 而 因 调 试 原 因 用 SensorManagerSimulator (Ú Ë- 

E'S Activity 的 onCreate() 方 法 , 在 该 方法 中 设置 当前 的 用 户 界面 , 然后 得 到 各 个 控件 的 引用 ， 
并 初始 化 SensorManager 或 SensorManagerSimulator。 

初始 化 监听 器 类 的 对 象 ， 在 重 写 的 onSensorChanged() 方 法 中 只 对 姿态 SENSOR. ORIENTATION 
变化 进行 处 理 ， 将 3 个 姿态 值 显 示 到 TextView 中 。 

重 写 Activity 的 onResume0) 方 法 , 在 该 方法 中 为 SensorManager 注册 监听 , 此 处 传 入 的 传感器 
类 型 为 SENSOR ORIENTATION， 表 示 只 读 取 姿态 数据 。 


jh 


文件 zitaiCH java 的 主要 代码 如 下 : 
public class zitaiLl extends Activity { 


TextView myTextView1; 

TextView myTextView2; 

TextView myTextView3; 

/声明 SensorManagerSimulator 对 象 ， 调 试 时 用 
SensorManagerSimulator mySensorManager; 


@Override 
public void onCreate(Bundle savedinstanceState) { /| 重 写 onCreate() 方 法 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); // 设 置 用 户 界面 
myTextView1 = (TextView) findViewByld(R.id.myTextView1); /imyTextView1 的 引用 
myTextView2 = (TextView) findViewByld(R.id.myTextView2); IImyTextView2 的 引用 
myTextView3 = (TextView) findViewByld(R.id.myTextView3); IImyTextView3 的 引用 
//mySensorManager = 
/|(SensorManager)getSystemService(SENSOR_SERVICE); // 获 得 SensorManager 
/调试 时 用 
mySensorManager = SensorManagerSimulator.getSystemService(this, SENSOR_SERVICE); 
mySensorManager.connectSimulator(); 1155 Simulator 服务 器 连接 
} 
private SensorListener mySensorListener = new SensorListener(){ 
@Override 
public void onAccuracyChanged(int sensor, int accuracy) {} / 重 写 onAccuracyChanged() 方 法 
@Override 
public void onSensorChanged(int sensor, float[] values) { 11% onSensorChanged()75;& 
if(sensor == SensorManager.SENSOR_ORIENTATION){ /检查 姿态 变化 
myTextView1.setText("Yaw 为 : "+values[0]); I[TextView 数据 显示 
myTextView2.setText("Pitch 为 : "+values[1]); IITextView 数据 显示 
myTextView3.setText("Roll 为 : "+values[2]); I[TextView 数据 显示 
} 
} 
E 
@Override 
protected void onResume() { 11% onResume() 方 法 
mySensorManager.registerListener( /注册 监听 
mySensorListener, /监听 器 SensorListener 对 象 
SensorManager.SENSOR ORIENTATION, /姿态 传感器 的 类 型 
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SensorManager.SENSOR DELAY UI /传感器 事件 传递 频 度 
); 
super.onResume(); 
} 
@Override 
protected void onPause() { II; onPause() 方 法 
mySensorManager.unregisterListener(mySensorListener); // 取 消 注册 监听 器 
super.onPause(); 
} 


} 
因为 此 实例 比较 简单 ， 是 根据 SensorSimulator 中 附带 的 开源 代码 改编 的 ， 所 以 在 此 不 再 进行 详细 


介绍 ， 读 者 只 需 阅读 本 书 附带 光盘 中 的 源码 即 可 。 
1224 ”实战 演练 一 一 开发 一 个 指南 针 程 序 


在 接 下 来 的 实例 中 ， 将 演示 在 Android 中 使 用 方向 传感器 开发 指南 针 应 用 程序 的 方法 。 在 本 实例 
中 首先 准备 一 张 指南 针 素 材 图 片 ， 该 图 片上 方向 指南 针 指向 北方 。 接 下 来 开发 一 个 检测 方向 的 传感器 ， 
传感器 程序 可 以 检测 到 手机 顶部 绕 Z 转 过 多 少 度 。 在 实例 中 需 添加 一 张 图 片 ， 并 让 图 片 总 是 反 转 方向 
传感器 返回 的 第 一 个 角度 值 。 


(1) 实现 布局 文件 
编写 布局 文件 main.xml， 功 能 是 插入 准备 好 的 素材 图 片 ， 主 要 实现 代码 如 下 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:background-" fff" 
> 


«ImageView 
android:id="@+id/znzlmage" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent" 
android:scaleType-"fitCenter" 
android:src="@drawable/compass" /> 
</LinearLayout> 


(2) 实现 程序 文件 
编写 程序 文件 Zhinanzheng.java， 使 用 传感器 获取 设备 的 旋转 角度 值 ， 并 根据 这 个 值 返回 指南 针 的 
角度 。 文 件 Zhinanzheng java 的 具体 实现 代码 如 下 : 


public class Zhinanzheng extends Activity implements SensorEventListener{ 


ImageView image; /指南 针 图 片 
float currentDegree = Of; /指南针 图 片 转 过 的 角度 


SensorManager mSensorManager; /管理 器 
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/** Called when the activity is first created. */ 

(QOverride 

public void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.main); 


image = (ImageView)findViewByld(R.id.znzimage); 
mSensorManager = (SensorManager)getSystemService(SENSOR SERVICE); /获取 管理 服务 


} 


@Override 
protected void onResume(){ 
super.onResume(); 
/注册 监听 器 
mSensorManager.registerListener(this, 
mSensorManager.getDefaultSensor(Sensor. TYPE ORIENTATION), SensorManager. SENSOR_ 
DELAY GAME); 
} 


/取消 注册 

@Override 

protected void onPause(){ 
mSensorManager.unregisterListener(this); 
super.onPause(); 


} 


@Override 

protected void onStop(){ 
mSensorManager.unregisterListener(this); 
super.onStop(); 


} 


/传感器 值 改变 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 


} 
// 精 度 改变 
@Override 
public void onSensorChanged(SensorEvent event) { 
// 获 取 触 发 event 的 传感器 类 型 
int sensorType = event.sensor.getType(); 


switch(sensorType){ 
case Sensor. TYPE_ORIENTATION: 
float degree = event values[0]; //3& Rx z 转 过 的 角度 
/定义 旋转 动画 对 象 ra 
RotateAnimation га = new RotateAnimation(currentDegree,-degree,Animation.RELATIVE_TO_ 
SELF,0.5f 
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,Animation.RELATIVE TO SELF,0.5f); 
ra.setDuration(100);// 动 画 持续 时 间 
image.startAnimation(ra); 
currentDegree = -degree; 
break; 


} 
} 
} 
执行 后 的 效果 如 图 12-3 所 示 。 


图 12-3 执行 效果 
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GR 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 陀 螺 仪 传感器 详解 .avi 

陀螺 仪 传感器 是 一 个 基于 自由 空间 移动 和 手势 的 定位 和 控制 系统 。 例 如 我 们 可 以 在 假想 的 平面 上 
移动 鼠标 ， 屏 幕 上 的 光标 就 会 随 之 跟着 移动 ， 并 且 可 以 绕 着 链接 画 圈 和 点 击 按键 。 又 如 当 我 们 正在 演 
讲 或 离开 桌子 时 ， 这 些 操作 都 能 够 很 方便 地 实现 。 陀 螺 仪 传感器 已 经 被 广泛 运用 于 手机 、 平 板 等 移动 
便携 设备 上 ， 在 将 来 设备 中 也 会 陆续 使 用 陀螺 仪 传感器 。 本 节 将 详细 讲解 在 Android 设备 中 使 用 陀螺 
仪 传感器 的 基本 知识 ， 为 读者 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


12.3.1 ”陀螺 仪 传感器 基础 


陀螺 仪 的 原理 是 ， 当 一 个 旋转 物体 的 旋转 轴 所 指 的 方向 在 不 受 外 力 影响 时 是 不 会 改变 的 。 根 据 这 
个 道理 ， 可 以 用 陀螺 仪 来 保持 方向 。 然 后 用 多 种 方法 读 取 轴 所 指示 的 方向 ， 并 自动 将 数据 信号 传 给 控 
制 系统 。 在 现实 生活 中 ， 骑 自行 车 便 是 利用 了 这 个 原理 。 轮 子 转 得 越 快 越 不 容易 倒 ， 因 为 车 轴 有 一 股 
保持 水 平 的 力量 。 现 代 陀螺 仪 是 一 个 能 够 精确 地 确定 运动 物体 的 方位 的 仪器 ， 也 是 在 现代 航空 、 航 海 、 
航天 和 国防 工业 中 广泛 使 用 的 一 种 惯性 导航 仪器 。 传 统 的 惯性 陀螺 仪 主要 部 分 有 机 械 式 的 陀螺 仪 ， 而 
机 械 式 的 陀螺 仪 对 工艺 结构 的 要 求 很 高 。20 世纪 70 年 代 提 出 了 现代 光纤 陀螺 仪 的 基本 设想 ， 到 20 世 
# 80 年 代 以 后 ， 光 纤 陀 螺 仪 就 得 到 了 非常 迅速 的 发 展 ， 激 光 谐振 陀螺 仪 也 有 了 很 大 的 发 展 。 光 纤 陀 螺 
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仪 具有 结构 紧凑 、 灵 敏 度 高 和 工作 可 靠 等 特点 。 光 纤 陀 螺 仪 在 很 多 的 领域 已 经 完全 取代 了 机 械 式 的 传 
统 的 陀螺 仪 ， 成 为 现代 导航 仪器 中 的 关键 部 件 。 

根据 框架 的 数目 和 支承 的 形式 以 及 附件 的 性 质 进行 划分 ， 陀 螺 仪 传感器 的 主要 类 型 如 下 所 示 。 

(1) 二 自由 度 陀螺 仪 : 只 有 一 个 框架 ， 使 转子 自转 轴 具 有 一 个 转动 自由 度 。 根 据 二 自由 度 陀螺 仪 
中 所 使 用 的 反作用 力 甜 的 性 质 ， 可 以 把 这 种 陀螺 仪 分 为 如 下 所 示 的 3 种 类 型 。 

加 ”积分 陀螺 仪 ( 它 使 用 的 反作用 力矩 是 阻尼 力矩 )。 

加 ”速率 陀螺 仪 ( 它 使 用 的 反作用 力矩 是 弹性 力矩 )。 

加 ”无 约束 陀螺 仪 〈 它 仅 有 惯性 反作用 力矩 )。 

另外 ， 除 了 机 、 电 框架 式 陀 螺 仪 外 还 出 现 了 某 些 新 型 陀螺 仪 ， 例 如 静电 式 自 由 转子 陀螺 仪 、 挠 性 
陀螺 仪 和 激光 陀螺 仪 等 。 

(2) 三 自由 度 陀螺 仪 : 具有 内 、 外 两 个 框架 ， 使 转子 自转 轴 具 有 两 个 转动 自由 度 。 在 没有 任何 力 
和 矩 装 置 时 ， 它 就 是 一 个 自由 陀螺 仪 。 
在 当前 技术 水 平 条 件 下 ， 陀 螺 仪 传感器 主要 被 用 于 如 下 两 个 领域 。 
(1) 国防 工业 
陀螺 仪 传感器 原本 是 运用 到 直升机 模型 上 的 ， 而 它 已 经 被 广泛 运用 于 手机 这 类 移动 便携 设备 上 ， 
不 仅 如 此 ,现代 陀螺 仪 是 一 种 能 够 精确 地 确定 运动 物体 的 方位 的 仪器 ， 所 以 陀螺 仪 传感器 是 现代 航空 、 
航海 、 航 天 和 国防 工业 应 用 中 必 不 可 少 的 控制 装置 。 陀 螺 仪 传感器 是 法 国 的 物理 学 家 莱 晶 。 傅 科 在 研 
究 地 球 自转 时 命名 的 ， 到 如 今 一 直 是 航空 和 航海 上 航行 姿态 及 速率 等 最 方便 实用 的 参考 仪表 。 

(2) 开门 报警 器 

陀螺 仪 传感器 可 以 测量 开门 的 角度 ， 当 门 被 打开 一 个 角度 后 回 发 出 报警 声 ， 或 者 结合 GPRS 模块 
发 送 短信 以 提醒 门 被 打开 了 。 另 外 ， 陀 螺 仪 传感器 集成 了 加 速度 传感器 的 功能 ， 当 门 被 打开 的 瞬间 ， 
将 产生 一 定 的 加 速度 值 ， 陀 螺 仪 传感器 将 会 测量 到 这 个 加 速度 值 ， 达 到 预 设 的 门槛 值 后 ， 将 发 出 报警 
声 ， 或 者 结合 GPRS 模块 发 送 短信 以 提醒 门 被 打开 了 。 报 警 器 内 还 可 以 集成 雷达 感应 测量 功能 ， 主 要 
有 人 进入 房间 内 移动 时 就 会 被 雷达 测量 到 。 双 重 保险 提醒 防盗 ， 可 靠 性 高 ， 误 报 率 低 ， 非 常 适合 重要 
场合 的 防盗 报警 。 


12.3.2 Android 中 的 陀螺 仪 传感器 


在 Android 系统 中 ， 陀 螺 仪 传感器 的 类 型 是 TYPE GYROSCOPE, 单位 是 rad/s, 能够 测量 设备 义 、 
Y. Z3 个 轴 的 角 加 速度 数据 。Android 中 的 陀螺 仪 传感器 又 名 为 Gyro-sensor 角速度 器 ， 它 利用 内 部 振 
动机 械 结 构 侦 测 物体 转动 所 产生 的 角速度 ， 进 而 计算 出 物体 移动 的 角度 。 侦 测 水 平 改变 的 状态 ， 但 无 
法 计算 移动 的 激烈 程度 。 下 面 将 详细 讲解 Android 中 陀螺 仪 传感器 的 基本 知识 。 

(1) 陀螺 仪 传感器 和 加 速度 传感器 的 对 比 

在 Android 的 传感器 系统 中 ， 陀 螺 仪 传感器 和 加 速度 传感器 非常 类 似 ， 两 者 的 区 别 如 下 所 示 。 

M ”加 速度 传感器 : 用 于 测量 加 速度 ， 借 助 一 个 3 轴 加 速度 计 可 以 测 得 一 个 固定 平台 相对 地 球 表 

面 的 运动 方向 ， 但 是 一 旦 平台 运动 起 来 ， 情 况 就 会 变 得 复杂 很 多 。 如 果 平台 做 自由 落体 ， 加 
速度 计 测 得 的 加 速度 值 为 零 。 如 果 平 台 朝 某 个 方向 做 加 速度 运动 ， 各 个 轴 向 加 速度 值 会 含有 
重力 产生 的 加 速度 值 ， 使 得 无 法 获得 真正 的 加 速度 值 。 例如 ， 安 装 在 60” 横 滚 角 飞机 上 的 3 
轴 加 速度 计 会 测 得 2G 的 垂直 加 速度 值 ， 而 事实 上 飞机 相对 地 区 表面 是 60° 的 倾角 。 因 此 ， 
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单独 使 用 加 速度 计 无 法 使 飞机 保持 一 个 固定 的 航向 。 

МЫ ”陀螺 仪 传感器 : 用 于 测量 机 体 围绕 某 个 轴 向 的 旋转 角 速 率 值 。 当 使 用 陀螺 仪 测量 飞机 机 体 轴 
向 的 旋转 角 速 率 时 ， 如 果 飞 机 在 旋转 ， 测 得 的 值 为 非 零 值 ， 飞 机 不 旋转 时 ， 测 量 的 值 为 零 。 
因此 ， 在 60” 横 滚 角 的 飞机 上 的 陀螺 仪 测 得 的 横 滚 角 速 率 值 为 零 ， 同 样 在 飞机 做 水 平 直线 飞 
行 时 的 角 速 率 值 为 零 。 可 以 通过 角 速 率 值 的 时 间 积分 来 估计 当前 的 横滨 角度 ， 前 提 是 没有 误 
差 的 累积 。 陀 螺 仪 测量 的 值 会 随时 间 漂 移 ， 经 过 几 分 钟 甚至 几 秒 钟 定 会 累积 出 额外 的 误差 来 ， 
而 最 终 会 导致 对 飞机 当前 相对 水 平面 横 滚 角度 完全 错误 的 认 知 。 因 此 ， 单 独 使 用 陀螺 仪 也 无 
法 保持 飞机 的 特定 航向 。 

综 上 所 述 ， 加 速度 传感器 在 较 长 时 间 的 测量 值 〈 确 定 飞 机 航向 ) 是 正确 的 ， 而 在 较 短 时 间 内 由 于 
信号 噪声 的 存在 而 有 误差 。 陀 螺 仪 传感器 在 较 短 时 间 内 会 比较 准确 ， 而 在 较 长 时 间 内 则 会 因为 漂移 的 
存在 而 产生 误差 。 因 此 ， 需 要 两 者 〈 相 互 调整 ) 来 确保 航向 的 正确 。 

(2) 物 联网 设备 中 的 陀螺 仪 传感器 
在 物 联 网 设备 中 ， 三 自由 度 陀螺 仪 是 一 个 可 以 识别 设备 ， 能 够 相对 于 地 面 绕 X、Y、Z 轴 转 动 角度 
的 感应 器 。 无 论 是 可 穿戴 设备 ， 还 是 智能 手机 、 平 板 电脑 ， 通 过 使 用 陀螺 仪 传感器 可 以 实现 很 多 好 玩 
的 应 用 ， 例 如 指南 针 。 

在 实际 开发 过 程 中 ， 可 以 用 一 个 磁场 感应 器 (Magnetic Sensor) 来 实现 陀螺 仪 。 磁 场 感应 器 是 用 来 
测量 磁场 感应 强度 的 ,一 个 3 轴 的 磁 Sensor IC 可 以 得 到 当前 环境 下 X\Y 和 了 方向 上 的 磁场 感应 强度 ， 
对 于 Android 中 间 层 来 说 就 是 读 取 该 感应 器 测量 到 的 这 3 个 值 。 当 需要 时 ， 上 报 给 上 层 应 用 程序 。 磁 
感应 强度 的 单位 是 T〈 特 斯 拉 ) 或 者 是 Gs〈 高 斯 )，1T 等 于 10000Gs。 

在 了 解 陀螺 仪 之 前 ， 需 要 先 了 解 Android 系统 定义 坐标 系 的 方法 ， 在 文件 hardware/libhardware/ 
include/hardware/sensors.h 中 进行 了 定义 。 

在 上 述 文件 sensors.h 中 ， 有 一 个 如 图 12-4 所 示 的 效果 图 。 

图 12-4 中 表示 设备 的 正 上 方 是 Y 轴 方 向 ， 右 边 是 X 轴 方 向 ， 垂 直 设备 屏幕 平面 向 上 的 是 Z 轴 方 
向 ， 这 个 很 重要 。 因 为 应 用 程序 就 是 根据 这 样 的 定义 来 写 的 ， 所 以 我 们 报 给 应 用 的 数据 要 和 这 个 定义 
符合 。 另 外 ， 还 需要 清楚 磁 Sensor 芯片 贴 在 板 上 的 坐标 系 。 我 们 从 芯片 读 出 数据 后 要 把 芯片 的 坐标 系 
转换 为 设备 的 实际 坐标 系 。 除 非 芯片 贴 在 板 上 刚好 和 设备 的 X、Y、Z 轴 方 向 一 致 。 

陀螺 仪 的 实现 是 根据 磁场 感应 强度 的 3 个 值 计 算出 另外 3 个 值 。 当 需要 时 可 以 计算 出 这 3 个 值 上 
报 给 应 用 程序 ， 这 样 就 实现 了 陀螺 仪 的 功能 。 下 面 将 详细 讲解 这 3 个 值 的 具体 含义 和 计算 方法 。 

(1) Azimuth 方位 角 : 即 绕 Z 轴 转 动 的 角度 ，0 度 = 正 北 。 假 设 立轴 指向 地 磁 正 北方 ， 直 升 机 正 
前 方 的 方向 如 图 12-5 所 示 。 
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图 12-4 Android 系统 定义 的 坐标 系 图 12-5 Azimuth 方位 角 
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90 度 = 正 东 时 如 图 12-6 所 示 。180 度 = 正 南 时 如 图 12-7 所 示 。 
| 


图 12-6 90 度 = 正 东 图 12-7 180 度 = 正 南 


270 度 = 正 西 时 如 图 12-8 所 示 。 

在 这 种 情况 下 ， 通 过 计算 X 和 立方 向 的 磁感应 强度 的 反正 切 的 方式 就 可 以 得 到 方位 角 。 要 想 实现 
指南 针 ， 只 需要 用 这 个 值 即 可 〈 不 考虑 设备 非 水 平 的 情况 )。 

(2) Pitch (M: 5€ X 轴 转 动 的 角度 〈-180<=pitch<=180)， 如 果 设 备 水 平 放置 ， 前 方向 下 俯 就 是 
正 值 ， 如 图 12-9 所 示 。 


РА 12-8 270 度 = 正 西 图 12-9 前 方向 下 俯 就 是 正 值 


前 方向 上 仰 就 是 负 值 ， 如 图 12-10 所 示 。 
在 这 种 情况 下 ， 计 算 磁 Sensor 的 Y 和 ZZ 反正 切 就 可 以 得 到 此 角度 值 ， 如 图 12-11 所 示 。 


图 12-10 ”前 方向 上 仰 就 是 负 值 图 12-11 计算 磁 Sensor 的 Y 和 Z 反 正切 
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124 ”实战 演练 一 一 联合 使 用 加 速度 传感器 和 陀螺 仪 传感器 


区 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 12 章 \ 联 合 使 用 加 速度 传感器 和 陀螺 仪 传感器 .avi 
本 节 将 详细 讲解 在 Android 设备 中 联合 使 用 加 速度 传感器 和 陀螺 仪 传感器 的 方法 。 本 节 的 陀螺 仪 
程序 演示 了 如 何 使 用 陀螺 仪 传感器 测量 Android 设备 的 旋转 角度 的 方法 。 本 实例 是 一 个 基于 Android 的 
Java 应 用 程序 ， 实 例 算法 的 JIST 可 以 应 用 于 几乎 任何 硬件 /语言 组 合 来 确定 线性 加 速度 。 本 陀螺 仪 实例 包 
fr Android 的 类 演示 了 如 何 使 用 SensorTYPE GYROSCOPE 和 Sensor.TYPE_GYROSCOPE_ 
UNCALIBRATED 两 种 传感器 的 方法 。 这 包括 集成 的 传感器 的 输出 随 着 时 间 的 推移 来 描述 角度 变化 的 
设备 、 初 始 化 旋转 矩阵 、 新 的 旋转 矩阵 的 Concatination 与 初始 旋转 矩阵 和 用 于 级 联 的 旋转 矩阵 提供 角度 。 
注意 : 陀螺 仪 类 型 Sensor. TYPE GYROSCOPE 会 因 设 备 的 移动 而 提供 误差 补偿 。 本 陀螺 仪 项 目 还 提供 
了 一 个 陀螺 仪 传感器 功能 ， 提 供 了 更 强大 和 可 靠 的 设备 的 Rotation 测量 值 。 本 传感器 实例 融合 
使 用 了 加 速度 传感器 、 磁 传感器 和 陀螺 仪 传感器 ， 联 合 使 用 上 述 传感器 来 实现 设备 的 快速 旋转 


或 外 部 振动 旋转 的 测量 工作 。 
实 例 | 功 能 源码 路 径 
.实例 12-5 | 联合 使 用 加 速度 传感器 和 陀螺 仪 传感器 ME 光复 :\daima\l2\GyroscopeEX — : 


1241 ”系统 介绍 界面 


系统 介绍 界面 的 布局 文件 是 introduction_ layoutxml， 功 能 是 在 屏幕 中 显示 系统 介绍 信息 ， 介 绍 了 
这 个 系统 的 主要 功能 。 文 件 introduction_ layout.xml 的 主要 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#88666666" > 


<ImageView 
android:id="@+id/introduction_image" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:layout centerInParent-"true" 
android:src-"(drawable/gyroscope explorer introduction 0" /> 


«Button 
android:id-"(Q)*id/button confirm" 
android:layout width-"250dp" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout centerInParent-"true" 
android:layout marginBottom-"10dp" 
android:layout marginTop-"10dp" 
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android:background="@drawable/confirm_button_background" 
android:text="@string/confirm_label" 
android:textAppearance="?android:attr/textAppearanceLarge" 
android:textColor="@color/white"” 
android:textStyle="bold" /> 

</RelativeLayout> 


文件 IntroductionActivityjava 的 功能 是 调用 系统 介绍 界面 的 布局 控件 ， 监 听 用 户 单 击 屏幕 底部 的 
按钮 ， 根 据 单 击 按钮 在 屏幕 中 显示 不 同 的 介绍 信息 界面 。 文 件 IntroductionActivity.java 的 具体 实现 代码 


如 下 H 
public class IntroductionActivity extends Activity implements OnClickListener 
{ 
private final static int INTRODUCTION 1 = 1; 
private final static int INTRODUCTION 2 = 2; 
private final static int INTRODUCTION 3 = 3; 
private final static int INTRODUCTION FINISHED = 4; 
private boolean hasRun; 
private int introductionCount = 0; 
@Override 
public void onCreate(Bundle savedinstanceState) 


{ 


super.onCreate(savedinstanceState); 
readHintsPrefs(); 
if (IhasRun) 


setContentView(R.layout.introduction_layout); 


Button button = (Button) this.findViewByld(R.id.button_confirm); 
button.setOnClickListener(this); 
} 


else 


{ 
} 


startGyroscopeActivity(); 


} 


private void startGyroscopeActivity() 


{ 
hasRun = true; 


writeHintsPrefs(); 


Intent intent = new Intent(); 
intent.setClass(this, GyroscopeActivity.class); 
startActivity(intent); 

} 


private void readHintsPrefs() 


{ 
SharedPreferences prefs = getSharedPreferences(PreferenceNames.HINTS, 
Activity. MODE_PRIVATE); 
hasRun = prefs.getBoolean(HintsPreferences.FIRST_RUN_HINTS_ENABLED, 


@ 
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false); 


} 


private void writeHintsPrefs() 
{ 
SharedPreferences.Editor editor = getSharedPreferences( 
PreferenceNames.HINTS, Activity. MODE_PRIVATE).edit(); 
editor.putBoolean(HintsPreferences.FIRST RUN HINTS ENABLED, hasRun); 
editor.commit(); 


} 


@Override 
public void onClick(View агд0) 
{ 
introductionCount++; 
ImageView introView = (ImageView) this 
-findViewByld(R.id.introduction_image); 


switch (introductionCount) 


{ 
case ІМТКОРОСТІОМ 1: 
introView 
.setlmageResource(R.drawable.gyroscope explorer introduction 1); 
break; 
case INTRODUCTION 2: 
introView 
.setlmageResource(R.drawable.gyroscope explorer introduction 2); 
break; 
case INTRODUCTION 3: 
introView 
.setlImageResource(R.drawable.gyroscope explorer introduction 3); 
break; 
case INTRODUCTION FINISHED: 
startGyroscopeActivity(); 
break; 


} 
} 
系统 介绍 界面 执行 后 的 效果 如 图 12-12 所 示 ， 单 击 I got this 按钮 会 显示 不 同 的 信息 介绍 界面 。 


图 12-12 系统 主 界面 
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系统 主 界面 


离开 系统 介绍 界面 会 进入 到 系统 主 界面 ， 在 系统 主 界面 中 将 以 图 形 化 的 方式 显示 当前 设备 的 陀螺 


仪 的 X、 


Y # Z ffi. 其 中 在 屏幕 下 方 显示 的 是 TYPE_ GYROSCOPE UNCALIBRATED 的 值 ， 这 表示 未 


经 过 校准 的 陀螺 仪 传感器 类 型 ， 没 有 经 过 陀螺 偏 移 补偿 。 然 而 ， 这 样 的 陀螺 漂移 偏差 值 分 别 退 还 给 结 
果 值 ， 可 以 把 它们 用 于 自 定义 校准 ， 在 屏幕 上 方 显示 经 过 校 验 的 陀螺 仪 值 。 系 统 主 界面 的 布局 文件 是 
activity_gyroscope.xml， 具 体 实现 代码 如 下 : 

<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 


@ 


xmlns:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:orientation="vertical" 
tools:context=".GyroscopeActivity" > 


<RelativeLayout 
android:id="@+id/layout_calibrated_header" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginTop-"5dp" > 


«RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" > 


«TextView 
android:id-"(Q-*id/label calibrated filter name" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_calibrated_name" 
android:textAppearance="?android:attr/textAppearanceSmall" 
android:textColor="@color/dark_orange" /> 


<TextView 
android:id="@+id/label_calibrated_filter_description” 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout toRightOf-"(g*id/label calibrated filter name" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_label" 
android:textAppearance="?android:attr/textAppearanceSmall" /> 
</RelativeLayout> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/layout_calibrated_status" 
android:layout_width="match_parent" 
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android:layout height-"wrap content" 
android:layout marginTop-"5dp" > 


<RelativeLayout 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" > 


«TextView 
android:id-"(Q-*id/label calibrated status" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_unavailable" 
android:textAppearance="?android:attr/textAppearanceMedium" 
android:textColor="@color/dark_red" /> 
</RelativeLayout> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/layout_calibrated_statistics" 
android:layout_width="match_parent" 
android:layout height-"wrap content" > 


<RelativeLayout 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" 
android:layout centerVertical-"true" > 


«TableLayout 
android:id-"(*id/table calibrated statistics left" 
android:layout width-"wrap content" 
android:layout height-"wrap content" > 


«TableRow 
android:id-"(g*id/table calibrated statistics left row 0" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:padding-"2dip" > 


<RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginRight-"20dp" 
android:layout weight-"1" » 


«TextView 
android:id-"(g)*id/label x axis calibrated" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
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android:layout_alignParentLeft="true" 
android:fontFamily-"sans-serif-condensed" 
android:text-"(gstring/label x axis" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


<TextView 

android:id="@+id/value_x_axis_calibrated" 

android:layout_width="wrap_content" 

android:layout height-"wrap content" 

android:layout toRightOf-"(*id/label x axis calibrated" 

android:fontFamily="sans-serif-condensed" 

android:text="@string/value_default" 

android:textAppearance-"?android:attr/textAppearanceMedium" /> 
</RelativeLayout> 


<RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout_weight="1" > 


<TextView 
android:id="@+id/label_y_axis_calibrated" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/label_y_axis" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


<TextView 
android:id="@+id/value_y_axis_calibrated" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_toRightOf="@+id/label_y_axis_calibrated" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/value_default" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 
</RelativeLayout> 


<RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"20dp" 
android:layout weight-"1" > 


«TextView 
android:id-"(g*id/label z axis calibrated" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:fontFamily="sans-serif-condensed" 
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android:text="@string/label_z_axis" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


<TextView 
android:id="@+id/value_z_axis_calibrated" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout toRightOf-"(*id/label z axis calibrated" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/value_default" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 
</RelativeLayout> 
</TableRow> 
</TableLayout> 
</RelativeLayout> 
</RelativeLayout> 


<View 
android:layout_width="fill_parent" 
android:layout_height="1dp" 
android:background="@android:color/darker_gray" /> 


<RelativeLayout 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginTop-"5dp" > 


«com.kircherelectronics.gyroscopeexplorer.activity.gauge.flat.GaugeBearingFlat 
android:id-"(-*id/gauge bearing calibrated" 
android:layout_width="140dp" 
android:layout_height="140dp" 
android:layout_alignParentLeft="true" 
android:layout_marginLeft="20dp" /> 


«com.kircherelectronics.gyroscopeexplorer.activity.gauge.flat.GaugeRotationFlat 
android:id-"(o*id/gauge tilt calibrated" 
android:layout_width="140dp" 
android:layout_height="140dp" 
android:layout alignParentRight-"true" 
android:layout marginRight-"20dp" /> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/layout_raw_header" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginTop-"20dp" > 


«RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
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android:layout centerHorizontal-"true" > 


«TextView 
android:id-"(Q*id/label raw filter name" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_uncalibrated_name" 
android:textAppearance-"?android:attr/textAppearanceSmall" 
android:textColor-"(gcolor/dark orange" /> 


<TextView 
android:id="@+id/label_raw_filter_description" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout toRightOf-"(g*id/label raw filter name" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_label" 
android:textAppearance-"?android:attr/textAppearanceSmall" /> 
</RelativeLayout> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/layout_uncalibrated_status" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginTop-"5dp" > 


«RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" > 


«TextView 
android:id="@+id/label_uncalibrated_status" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/sensor_unavailable" 
android:textAppearance="?android:attr/textAppearanceMedium" 
android:textColor="@color/dark_red" /> 
</RelativeLayout> 
</RelativeLayout> 


<RelativeLayout 
android:id="@+id/layout_raw_statistics" 
android:layout_width="match_parent" 
android:layout height-"wrap content" > 


«RelativeLayout 
android:layout width-"wrap content" 


(m, 


вое юшшеви, эа®тиюк ева ОО 


android:layout_height="wrap_content" 
android:layout centerHorizontal-"true" 
android:layout centerVertical-"true" > 


«TableLayout 


android:id-"(Q)*id/table raw statistics left" 
android:layout width-"wrap content" 
android:layout height-"wrap content" > 


«TableRow 


android:id-"Q*id/table raw statistics left row 0" 
android:layout width-"fill parent" 

android:layout height-"wrap content" 
android:padding-"2dip" > 


<RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginRight-"20dp" 
android:layout_weight="1" > 


<TextView 


android:id="@+id/label_x_axis_raw" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentLeft="true" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/label_x_axis" 
android:textAppearance="?android:attr/textAppearanceMedium" /> 


<TextView 


android:id-"(g*id/value x axis raw" 

android:layout width-"wrap. content" 

android:layout height-"wrap content" 

android:layout toRightOf-"(g*id/label x axis raw" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/value_default" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


</RelativeLayout> 


<RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1" » 


«TextView 


android:id="@+id/label_y_axis_raw" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:fontFamily="sans-serif-condensed" 
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android:text="@string/label_y_axis" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


<TextView 

android:id="@+id/value_y_axis_raw" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout toRightOf-"(*id/label y axis raw" 
android-fontFamily-"sans-serif-condensed" 
android:text-"Qstring/value default" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 

</RelativeLayout> 


<RelativeLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"20dp" 
android:layout_weight="1" > 


<TextView 
android:id-"(g*id/label z axis raw" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/label_z_axis" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 


<TextView 
android:id="@+id/value_z_axis_raw" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_toRightOf="@+id/label_z_axis_raw" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/value_default" 
android:textAppearance-"?android:attr/textAppearanceMedium" /> 
</RelativeLayout> 
</TableRow> 
</TableLayout> 
</RelativeLayout> 
</RelativeLayout> 


<View 
android:layout_width="fill_parent" 
android:layout_height="1dp" 
android:background="@android:color/darker_gray" /> 
<RelativeLayout 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginTop-"5dp" > 
«com.kircherelectronics.gyroscopeexplorer.activity.gauge.flat. GaugeBearingFlat 
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android:id="@+id/gauge_bearing_raw" 
android:layout_width="140dp" 
android:layout_height="140dp" 
android:layout alignParentLeft-"true" 
android:layout marginLeft-"20dp" /> 
<com.kircherelectronics.gyroscopeexplorer.activity.gauge.flat.GaugeRotationFlat 
android:id="@+id/gauge_tilt_raw" 
android:layout_width="140dp" 
android:layout_height="140dp" 
android:layout alignParentRight-"true" 
android:layout marginRight-"20dp" /> 
</RelativeLayout> 
<RelativeLayout 
android:layout width-"match parent" 
android:layout height-"fill parent" > 
<RelativeLayout 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout_above="@+id/color_bar" > 
<RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" > 
<ImageView 
android:id="@+id/image_developer_icon" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginRight-"4dp" 
android:src="@drawable/ke_icon" /> 
<TextView 
android:id="@+id/label_developer_description" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_toRightOf="@+id/image_developer_icon" 
android:fontFamily="sans-serif-condensed" 
android:text="@string/developer_url" 
android:textAppearance-"?android:attr/textAppearanceSmall" /> 
</RelativeLayout> 
</RelativeLayout> 
<RelativeLayout 
android:id="@+id/color_bar" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout marginBottom-"5dp" 
android:layout marginTop-"5dp" > 
<RelativeLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout centerHorizontal-"true" > 
«ImageView 
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android:id="@+id/image_color_bar" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src="@drawable/color_bar" /> 
</RelativeLayout> 
</RelativeLayout> 


</RelativeLayout> 


</LinearLayout> 


文件 GyroscopeActivityjava 调用 了 系统 3 


界面 布局 文件 中 的 控件 ， 显 示 当 前 设备 的 陀螺 仪 传感器 
的 值 。 在 显示 传感器 数据 值 时 ， 是 通过 表盘 样式 的 图 形 化 界面 显示 的 。 并 且 还 能 够 监听 用 户 在 系统 3 


界面 中 的 单 击 动作 ， 并 根据 单 击 动作 来 设置 执行 对 应 的 事件 处 理 程序 。 文 件 GyroscopeActivityjava 的 
具体 实现 代码 如 下 : 
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public class GyroscopeActivity extends Activity implements SensorEventListener, 


FusedGyroscopeSensorListener 


public static final float EPSILON = 0.000000001f; 


private static final String tag = GyroscopeActivity.class.getSimpleName(); 


private static final float NS2S = 1.0f / 1000000000.0f; 
private static final int MEAN_FILTER_WINDOW = 10; 
private static final int MIN SAMPLE COUNT = 30; 
private boolean haslnitialOrientation = false; 
private boolean statelnitializedCalibrated = false; 
private boolean statelnitializedRaw = false; 

private boolean useFusedEstimation = false; 
private boolean useRadianUnits = false; 

/表盘 形式 视图 

private GaugeBearingFlat gaugeBearingCalibrated; 
private GaugeBearingFlat gaugeBearingRaw; 
private GaugeRotationFlat gaugeTiltCalibrated; 
private GaugeRotationFlat gaugeTiltRaw; 

private DecimalFormat df; 

/校准 值 

private float[] currentRotationMatrixCalibrated; 
private float[] deltaRotationMatrixCalibrated; 
private float[] deltaRotationVectorCalibrated; 
private float] gyroscopeOrientationCalibrated; 

// 未 校准 值 

private float[] currentRotationMatrixRaw; 

private float[] deltaRotationMatrixRaw; 

private float[] deltaRotationVectorRaw; 

private float[] gyroscopeOrientationRaw; 

/加 速度 计 和 磁力 计 的 基础 旋转 矩阵 

private float[] initialRotationMatrix; 

/加 速度 矢量 

private float[] acceleration; 

// 磁 场 撩 量 

private float[] magnetic; 


private FusedGyroscopeSensor fusedGyroscopeSensor; 


private int accelerationSampleCount = 0; 
private int magneticSampleCount = 0; 
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private long timestampOldCalibrated = 0; 

private long timestampOldRaw = 0; 

private MeanFilter accelerationFilter; 

private MeanFilter magneticFilter; 

/| 需要 SensorManager 来 注册 传感器 事件 

private SensorManager sensorManager; 

private TextView xAxisRaw; 

private TextView yAxisRaw; 

private TextView zAxisRaw; 

private TextView xAxisCalibrated; 

private TextView yAxisCalibrated; 

private TextView zAxisCalibrated; 

@Override 

protected void onCreate(Bundle savedinstanceState) 

{ 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity_gyroscope); 


initUl(); 
initMaths(); 
initSensors(); 
initFilters(); 

Е 

@Override 


public boolean onCreateOptionsMenu(Menu menu) 
{ 
getMenulnflater().inflate(R.menu.gyroscope, menu); 
return true; 
} 
p 
* 监听 用 户 选 择 的 处 理 菜单 的 id 
Л 
@Override 
public boolean onOptionsitemSelected(Menultem item) 


{ 


switch (item.getltemld()) 
{ 
// 重 置 所 有 信息 
case R.id.action_reset: 
reset(); 
restart(); 
return true; 
// 复 位 所 有 信息 


case R.id.action_config: 
Intent intent = new Intent(); 
intent.setClass(this, ConfigActivity.class); 
startActivity(intent); 
return true; 

default: 
return super.onOptionsitemSelected(item); 


} 
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public void onResume() 


{ 
super.onResume(); 
readPrefs(); 
restart(); 
} 
public void onPause() 
{ 
super.onPause(); 
reset(); 
) 
@Override 
public void onSensorChanged(SensorEvent event) 
{ 
if (event.sensor.getType() == Sensor. TYPE_ACCELEROMETER) 
{ 
onAccelerationSensorChanged(event.values, event.timestamp); 
} 
if (event.sensor.getType() == Sensor. TYPE_MAGNETIC_FIELD) 
{ 
onMagneticSensorChanged(event.values, event.timestamp); 
} 
if (event.sensor.getType() == Sensor. TYPE_GYROSCOPE) 
{ 
onGyroscopeSensorChanged(event.values, event.timestamp); 
} 
if (event.sensor.getType() == Sensor. TYPE_GYROSCOPE_UNCALIBRATED) 
{ 
onGyroscopeSensorUncalibratedChanged(event.values, event.timestamp); 
} 
} 
@Override 
public void onAngularVelocitySensorChanged(float[] angularVelocity, 
long timeStamp) 
{ 


gaugeBearingCalibrated.updateBearing(angularVelocity[0]); 
gaugeTiltCalibrated.updateRotation(angularVelocity); 
TextView status = (TextView) this 
-findViewByld(R.id.label calibrated status); 
status.setText(R.string.sensor active); 
int color = getResources().getColor(R.color.light green); 
status.setTextColor(color); 
if (useRadianUnits) 
{ 
xAxisCalibrated.setText(df.format(angularVelocity[0])); 
yAxisCalibrated.setText(df.format(angularVelocity[1])); 
zAxisCalibrated.setText(df.format(angularVelocity[2])); 
} 


else 


{ 
xAxisCalibrated.setText(df.format(Math 
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-toDegrees(angularVelocity[0]))); 
yAxisCalibrated.setText(df.format(Math 

-toDegrees(angularVelocity[1]))); 
zAxisCalibrated.setText(df.format(Math 

-toDegrees(angularVelocity[2]))); 


} 
} 
public void onAccelerationSensorChanged(float[] acceleration, long timeStamp) 
{ 


// 从 设备 传感器 获取 原始 磁场 值 的 本 地 副本 

System.arraycopy(acceleration, 0, this.acceleration, 0, 
acceleration.length); 

// 使 用 均值 滤波 来 平滑 输入 传感器 

this.acceleration = accelerationF ilter.filterFloat(this.acceleration); 

// 统 计 接 收 到 的 样本 数 

accelerationSampleCount++; 

/唯一 确定 的 初始 方向 的 加 速度 传感器 和 磁 传感器 

/有 足够 的 时 间 由 平均 滤波 器 进行 平滑 处 理 

// 如 果 方 向 尚未 确定 ， 只 需要 一 次 

if (accelerationSampleCount > MIN SAMPLE COUNT 
&& magneticSampleCount > MIN_SAMPLE_COUNT 
&& !hasinitialOrientation) 


{ 
} 


calculateOrientation(); 


} 
public void onGyroscopeSensorChanged(float[] gyroscope, long timestamp) 
{ 

// 不 启动 ， 直 到 第 一 个 加 速度 计 / 磁 方位 已 被 取得 

if (IhaslnitialOrientation) 

{ 


return; 


} 
// 基 于 陀螺 仪 的 旋转 矩阵 的 初始 化 
if (IstatelnitializedCalibrated) 
{ 
currentRotationMatrixCalibrated = matrixMultiplication( 
currentRotationMatrixCalibrated, initialRotationMatrix); 
statelnitializedCalibrated = true; 
TextView status = (TextView) this 
-findViewByld(R.id.label calibrated status); 
status.setText(R.string.sensor active); 
int color = getResources().getColor(R.color.light green); 
status.setTextColor(color); 


} 
// 这 个 时 间 步 长 的 三 角形 旋转 值 ， 将 和 目前 的 从 旋转 陀螺 采样 的 数据 计算 后 相 乘 
if (timestampOldCalibrated != 0 && statelnitializedCalibrated) 
{ 
final float dT = (timestamp - timestampOldCalibrated) * NS2S; 
float axisX = gyroscope[0]; 
float axisY = gyroscope[1]; 
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float axisZ = gyroscope[2]; 
// 计 算出 这 个 实例 的 角速度 
float omegaMagnitude = (float) Math.sqrt(axisX * axisX + axisY 
* axisY + axisZ * axisZ); 
if (omegaMagnitude > EPSILON) 
{ 
axisX /= omegaMagnitude; 
axisY /= omegaMagnitude; 
axisZ /= omegaMagnitude; 


} 

/根据 时 间 步 长 获得 一 个 增 量 旋转 ， 即 计算 围绕 此 轴 旋 转 的 角速度 值 

/将 获取 的 旋转 矩阵 值 转换 成 一 个 四 元 数 

float thetaOverTwo = omegaMagnitude * dT / 2.0f; 

float sinThetaOverTwo = (float) Math.sin(thetaOverTwo); 

float cosThetaOverTwo = (float) Math.cos(thetaOverTwo); 

deltaRotationVectorCalibrated[0] = sinThetaOverTwo * axisX; 

deltaRotationVectorCalibrated[1] = sinThetaOverTwo * axisY; 

deltaRotationVectorCalibrated[2] = sinThetaOverTwo * axisZ; 

deltaRotationVectorCalibrated[3] = cosThetaOverTwo; 

SensorManager.getRotationMatrixFromVector( 
deltaRotationMatrixCalibrated, 
deltaRotationVectorCalibrated); 

currentRotationMatrixCalibrated = matrixMultiplication( 
currentRotationMatrixCalibrated, 
deltaRotationMatrixCalibrated); 

SensorManager.getOrientation(currentRotationMatrixCalibrated, 
gyroscopeOrientationCalibrated); 


timestampOldCalibrated = timestamp; 
gaugeBearingCalibrated.updateBearing(gyroscopeOrientationCalibrated[0]); 
gaugeTiltCalibrated.updateRotation(gyroscopeOrientationCalibrated); 

if (useRadianUnits) 


xAxisCalibrated.setText(df 
-format(gyroscopeOrientationCalibrated[0])); 

yAxisCalibrated.setText(df 
-format(gyroscopeOrientationCalibrated[1])); 

zAxisCalibrated.setText(df 
-format(gyroscopeOrientationCalibrated[2])); 


} 
else 
{ 
xAxisCalibrated.setText(df.format(Math 
-toDegrees(gyroscopeOrientationCalibrated[0]))); 
yAxisCalibrated.setText(df.format(Math 
.toDegrees(gyroscopeOrientationCalibrated[1]))); 
zAxisCalibrated.setText(df.format(Math 
.toDegrees(gyroscopeOrientationCalibrated[2]))); 
} 


} 
public void onGyroscopeSensorUncalibratedChanged(float[] gyroscope, 
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long timestamp) 


/不 启动 ， 直 到 第 一 个 加 速度 计 / 磁 方位 已 被 获取 
if (IhaslnitialOrientation) 


{ 
return; 
} 
if (IstatelnitializedRaw) 
{ 


currentRotationMatrixRaw = matrixMultiplication( 
currentRotationMatrixRaw, initialRotationMatrix); 

statelnitializedRaw = true; 

TextView status = (TextView) this 
-findViewByld(R.id.label_uncalibrated_status); 

status.setText(R.string.sensor_active); 

int color = getResources().getColor(R.color.light_green); 

status.setTextColor(color); 


} 
if (timestampOldRaw != 0 && statelnitializedRaw) 
{ 
final float dT = (timestamp - timestampOldRaw) * NS2S; 
float axisX = gyroscope[0]; 
float axisY = gyroscope[1]; 
float axisZ = gyroscope[2]; 
float omegaMagnitude = (float) Math.sqrt(axisX * ахіѕХ + axisY 
* axisY + axisZ * axisZ); 
/规范 化 旋转 向 量 ， 如 果 它 足够 大 ， 以 获得 轴 
if (omegaMagnitude > EPSILON) 


axisX /= omegaMagnitude; 
axisY /= omegaMagnitude; 
axisZ /= omegaMagnitude; 
} 
float thetaOverTwo = omegaMagnitude * dT / 2.0f; 
float sinThetaOverTwo - (float) Math.sin(thetaOverTwo); 
float cosThetaOverTwo = (float) Math.cos(thetaOverTwo); 
deltaRotationVectorRaw[0] = sinThetaOverTwo * axisX; 
deltaRotationVectorRaw[1] = sinThetaOverTwo * axisY; 
deltaRotationVectorRaw[2] = sinThetaOverTwo * axisZ; 
deltaRotationVectorRaw[3]  cosThetaOverTwo; 
SensorManager.getRotationMatrixFromVector(deltaRotationMatrixRaw, 
deltaRotationVectorRaw); 
currentRotationMatrixRaw = matrixMultiplication( 
currentRotationMatrixRaw, deltaRotationMatrixRaw); 
SensorManager.getOrientation(currentRotationMatrixRaw, 
gyroscopeOrientationRaw); 
} 
timestampOldRaw = timestamp; 
gaugeBearingRaw.updateBearing(gyroscopeOrientationRaw[0]); 
gaugeTiltRaw.updateRotation(gyroscopeOrientationRaw); 
if (useRadianUnits) 
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xAxisRaw.setText(df format(gyroscopeOrientationRaw[0])); 
yAxisRaw.setText(df format(gyroscopeOrientationRaw[1])); 
zAxisRaw.setText(df format(gyroscopeOrientationRaw[2])); 
} 
else 
{ 
xAxisRaw.setText(df.format(Math 
XoDegrees(gyroscopeOrientationRaw[0]))); 
yAxisRaw.setText(df.format(Math 
XAoDegrees(gyroscopeOrientationRaw[1]))); 
zAxisRaw.setText(df.format(Math 
.toDegrees(gyroscopeOrientationRaw(2]))); 
} 
} 
public void onMagneticSensorChanged(float[] magnetic, long timeStamp) 
{ 
/从 设备 传感器 获取 原始 磁场 值 的 本 地 副本 
System.arraycopy(magnetic, 0, this.magnetic, 0, magnetic.length); 
/使 用 均值 滤波 来 平滑 输入 传感器 
this.magnetic = magneticFilter.filterFloat(this. magnetic); 
magneticSampleCount++; 
} 
p 
* 计 算 当 前 方向 角度 的 加 速度 计 和 磁力 计 的 输出 值 
al 
private void calculateOrientation() 
{ 
haslnitialOrientation = SensorManager.getRotationMatrix( 
initialRotationMatrix, null, acceleration, magnetic); 
if (haslnitialOrientation) 
{ 
sensorManager.unregisterListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER)); 
sensorManager.unregisterListener(this, 
sensorManager.getDefaultSensor(Sensor. TYPE_MAGNETIC_FIELD)); 


} 
n 
“初始 化 平均 过 滤器 
学 
private void initFilters() 
Í 
accelerationFilter = new MeanFilter(); 
accelerationFilter.setWindowSize(MEAN_FILTER_WINDOW); 
magneticFilter = new MeanFilter(); 
magneticFilter.setWindowSize(MEAN_FILTER_WINDOW); 
] 
fa 
“初始 化 所 需 的 数字 数据 结构 
" 


@ 
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private void initMaths() 
{ 
acceleration = new float[3]; 
magnetic = new float[3]; 
initialRotationMatrix = new float[9]; 
deltaRotationVectorCalibrated = new float[4]; 
deltaRotationMatrixCalibrated = new float[9]; 
currentRotationMatrixCalibrated = new float[9]; 
gyroscopeOrientationCalibrated = new float[3]; 
/初始 化 当前 旋转 矩阵 为 单位 矩阵 
currentRotationMatrixCalibrated[0] = 1.0; 
currentRotationMatrixCalibrated[4] = 1.0; 
currentRotationMatrixCalibrated[8] = 1.0; 
deltaRotationVectorRaw = new float[4]; 
deltaRotationMatrixRaw = new float[9]; 
currentRotationMatrixRaw = new float[9]; 
gyroscopeOrientationRaw = new float[3]; 
/初始 化 当前 旋转 矩阵 为 单位 矩阵 
currentRotationMatrixRaw[0] = 1.0f; 
currentRotationMatrixRaw[4] = 1.0f; 
currentRotationMatrixRaw[8] = 1.0f; 
} 
p 
“初始 化 传感器 
Zn 
private void initSensors() 
{ 
sensorManager = (SensorManager) this 
.getSystemService(Context.SENSOR SERVICE); 
fusedGyroscopeSensor - new FusedGyroscopeSensor(); 
} 
n 
* 初始 化 Ul AB 
3 
private void initUI() 
{ 
/获取 一 个 十 进 制 格式 的 文本 意见 
df = new DecimalFormat("#.##"); 
// 初 始 化 原始 未 校准 ) 文本 视图 
xAxisRaw = (TextView) this.findViewByld(R.id.value_x_axis_raw); 
yAxisRaw = (TextView) this.findViewByld(R.id.value y axis raw); 
zAxisRaw = (TextView) this.findViewByld(R.id.value z axis raw); 
// 初 始 化 校准 的 文本 视图 
xAxisCalibrated = (TextView) this 
-findViewByld(R.id.value_x_axis_calibrated); 
yAxisCalibrated = (TextView) this 
-findViewByld(R.id.value_y_axis_calibrated); 
zAxisCalibrated = (TextView) this 
-findViewByld(R.id.value_z_axis_calibrated); 
/初始 化 原始 〈 未 校准 ) 的 文本 视图 
gaugeBearingRaw = (GaugeBearingFlat) findViewByld(R.id.gauge_bearing_raw); 
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gaugeTiltRaw = (GaugeRotationFlat) findViewByld(R.id.gauge_tilt_raw); 
// 初 始 化 校准 的 仪表 视图 
gaugeBearingCalibrated = (GaugeBearingFlat) findViewByld(R.id.gauge_bearing_calibrated); 
gaugeTiltCalibrated = (GaugeRotationFlat) findViewByld(R.id.gauge_tilt_calibrated); 
} 
p 
"ЖР а" 
* @рагат а 
* @param b 
* @return a*b 
ah 
private float[] matrixMultiplication(float[] a, float[] b) 
{ 
float[] result = new float[9]; 
result[0] = a[0] * b[0] + a[1] * b[3] + a[2] * b[6]; 
result[1] = a[0] * b[1] + a[1] * b[4] + a[2] * b[7]; 
result[2] = a[0] * b[2] + a[1] * b[5] + a[2] * b[8]; 
result[3] = a[3] * b[0] + a[4] * b[3] + a[5] * b[6]; 
result[4] = a[3] * b[1] + a[4] * b[4] + a[5] * b[7]; 
result[5] = a[3] * b[2] + a[4] * b[5] + a[5] * b[8]; 
result[6] = a[6] * b[0] + a[7] * b[3] + a[8] * b[6]; 
result[7] = a[6] * b[1] + a[7] * b[4] + a[8] * b[7]; 
result[8] = a[6] * b[2] + a[7] * b[5] + a[8] * b[8]; 
return result; 


@TargetApi(Build. VERSION CODES.JELLY BEAN MR2) 
private void restart() 
{ 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR DELAY FASTEST); 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE MAGNETIC FIELD), 
SensorManager.SENSOR_DELAY_FASTEST); 
if (luseFusedEstimation) 


{ 
boolean enabled = sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE GYROSCOPE), 
SensorManager.SENSOR DELAY FASTEST); 
if (lenabled) 
{ 
showGyroscopeNotAvailableAlert(); 
} 
} 
if (Utils. hasKitKat()) 
{ 


sensorManager.registerListener(this, sensorManager 
.getDefaultSensor(Sensor. TYPE GYROSCOPE UNCALIBRATED), 


oo, 
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SensorManager.SENSOR_DELAY_FASTEST); 
} 
if (useFusedEstimation) 
{ 
boolean hasGravity = sensorManager.registerListener( 
fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor. TYPE_GRAVITY), 
SensorManager.SENSOR_DELAY_FASTEST); 
if (IhnasGravity) 
{ 
sensorManager.registerListener(fusedGyroscopeSensor, 
sensorManager 
.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
SensorManager.SENSOR DELAY FASTEST); 
) 
sensorManager.registerListener(fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor. TYPE MAGNETIC FIELD), 
SensorManager.SENSOR DELAY FASTEST); 
boolean enabled = sensorManager.registerListener( 
fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor.TYPE GYROSCOPE), 
SensorManager.SENSOR DELAY FASTEST); 
if (lenabled) 
{ 
showGyroscopeNotAvailableAlert(); 


} 
TextView label = (TextView) this 
-findViewByld(R.id.label calibrated filter name); 
label.setText("Fused" 
* getResources().getString(R.string.sensor calibrated name)); 
fusedGyroscopeSensor.registerObserver(this); 
) 
else 
{ 
TextView label = (TextView) this 
findViewByld(R.id.label_calibrated_filter_name); 
label.setText(getResources().getString( 
R.string.sensor_calibrated_name)); 


} 
n 
“删除 所 有 的 传感器 数据 信息 
* 
I 
GTargetApi(Build. VERSION CODES.JELLY BEAN MR2) 
private void reset() 
{ 
sensorManager.unregisterListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER)); 
sensorManager.unregisterListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE MAGNETIC FIELD)); 
if (luseFusedEstimation) 
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{ 
sensorManager.unregisterListener(this, 
sensorManager.getDefaultSensor(Sensor. TYPE_GYROSCOPE)); 
} 
if (Utils.hasKitKat()) 
{ 
sensorManager.unregisterListener(this, sensorManager 
.getDefaultSensor(Sensor. TYPE GYROSCOPE UNCALIBRATED)); 
} 
if (useFusedEstimation) 
{ 
sensorManager.unregisterListener(fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor.TYPE GRAVITY)); 
sensorManager.unregisterListener(fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER)); 
sensorManager.unregisterListener(fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor. TYPE_MAGNETIC_FIELD)); 
sensorManager.unregisterListener(fusedGyroscopeSensor, 
sensorManager.getDefaultSensor(Sensor. TYPE_GYROSCOPE)); 
fusedGyroscopeSensor.removeObserver(this); 
} 
initMaths(); 


accelerationSampleCount = 0; 
magneticSampleCount = 0; 
haslnitialOrientation = false; 
statelnitializedCalibrated = false; 
statelnitializedRaw = false; 


} 


private void readPrefs() 


SharedPreferences prefs = PreferenceManager 
.getDefaultSharedPreferences(this); 
useFusedEstimation 7 prefs.getBoolean(ConfigActivity.FUSION PREFERENCE, 
false); 
useRadianUnits 7 prefs 
.getBoolean(ConfigActivity. UNITS. PREFERENCE, true); 
Log.d(tag, "Fusion: " * String.valueOf(useFusedEstimation)); 
Log.d(tag, "Units Radians: " * String.valueOf(useRadianUnits)); 
} 
private void showGyroscopeNotAvailableAlert() 
{ 
AlertDialog.Builder alertDialogBuilder = new AlertDialog.Builder(this); 
// 设 置 标题 
alertDialogBuilder.setTitle("Gyroscope Not Available"); 
/设置 对 话 框 消息 
alertDialogBuilder 
.setMessage( 
"Your device is not equipped with a gyroscope or it is not responding...") 
.setCancelable(false) 
.setNegativeButton('l'll look around...", 
new Dialoginterface.OnClickListener() 
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public void onClick(DialogInterface dialog, int id) 
{ 


} 


dialog.cancel(); 


/创建 警报 对 话 框 
AlertDialog alertDialog = alertDialogBuilder.create(); 
alertDialog.show(); 

} 


@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) 


{ 


} 
} 
至 此 ， 整 个 实例 介绍 完毕 ， 因 为 是 在 模拟 器 中 运行 ， 所 以 系统 主 界面 的 执行 效果 如 图 12-13 所 示 。 
在 有 陀螺 仪 传感器 的 物 联网 真 机 设备 中 运行 本 程序 ， 会 显示 正确 的 预期 效果 。 


X-Axis:0.0 Ү-Ахів:0.0 Z-Axis:0.0 


Ow 


X-Axis:0.0 Ү-Ахіє:00 Z-Axis:0.0 


Or” 


图 12-13 执行 效果 
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在 Android 设备 应 用 程序 开发 过 程 中 ， 经 常 使 用 旋转 向 量 传感器 、 距 离 传感器 和 气压 传感器 来 检 
测 当 前 设备 所 处 的 环境 参数 。 本 章 将 详细 讲解 在 Android 设备 中 使 用 旋转 向 量 传感器 、 距 离 传感器 和 
气压 传感器 的 方法 。 


13.1 旋转 向 量 传感器 详解 


GC 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 13 章 \ 旋 转向 量 传感器 详解 .avi 

在 Android 系统 中 ,旋转 向量 传感器 的 值 是 TYPE_ROTATION_VECTOR,， 旋转 矢量 代表 设备 的 方 
向 ， 是 一 个 将 坐标 轴 和 角度 混合 计算 得 到 的 数据 。 本 节 将 详细 讲解 Android 系统 中 旋转 向 量 传感器 的 
基本 知识 。 


13.1.1 Android 中 的 旋转 向 量 传感器 


Android 旋转 向 量 传感器 的 具体 说 明 如 表 13-1 所 示 。 
表 13-1 Android 旋转 向 量 传感器 的 具体 说 明 


测量 单位 
旋转 向 量 沿 XX 轴 的 部 分 (xxsin(9/2)) 
me SensorEvent.values[1 旋转 向 量 沿 Y 轴 的 部 分 (yxsin(6/2)) x 
一 Е SensorEventvalues[2] | 旋转 向 量 沿 Z 轴 的 部 分 (zxsin(8/2)) 
旋转 向 量 的 数值 部 分 ((cos(8/2)) 

由 表 13-1 可 知 ，RV-sensor 能 够 输出 如 下 所 示 的 3 个 数据 : 

xxsin(0/2) 

yxsin(0/2) 

М zxsin(0/2) 

则 sin(theta/2) 表 示 RV 的 数量 级 ,RV 的 方向 与 轴 旋 转 的 方向 相同 ,这 样 RV 的 3 个 数值 与 cos(theta/2) 
组 成 一 个 四 元 组 。 而 RV 的 数据 没有 单位 ， 使 用 的 坐标 系 与 加 速度 相同 。 例 如 下 面 的 演示 代码 。 

sensors_event_t.data[0] = x*sin(theta/2) 

sensors event t.data[1] = y*sin(theta/2) 


sensors event t.data[2] = z*sin(theta/2) 
sensors event t.data[3] = cos(theta/2) 
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GV. LA 和 RV 的 数值 物理 传感器 没有 直接 给 出 ， 需 要 G-sensor. O-sensor 和 Gyro-sensor 经 过 算 
法 计算 后 得 出 。 
由 此 可 见 ， 旋 转向 量 代表 了 设备 的 方位 ， 这 个 方位 结果 由 角度 和 坐标 轴 信 息 组 成 ， 在 里 面包 含 了 
设备 围绕 坐标 轴 CX. Y. Z) 旋转 的 角度 96。 例如 下 面 的 代码 演示 了 获取 默认 的 旋转 向 量 传感器 的 方法 。 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager = (SensorManager) getSystemService(Context.SENSOR SERVICE); 
mSensor = mSensorManager.getDefaultSensor(Sensor. TYPE ROTATION VECTOR); 


在 Android 系统 中 , 旋转 向 量 的 3 个 元 素 等 于 四 元 组 的 后 3 个 部 分 (cos(8/2)、xxsin(8/2)、yxsin(8/2)、 
zxsin(9/2))， 没 有 单位 。X、Y、Z 轴 的 具体 定义 与 加 速度 传感器 的 相 y 
同 。 旋 转向 量 传感器 的 坐标 系 如 图 13-1 所 示 。 
上 述 坐 标 系 具 有 如 下 所 示 的 特点 。 
М X: 定义 为 向 量 积 YxZ。 它 是 以 设备 当前 位 置 为 切 点 的 地 球 z 
切线 ， 方 向 向 东 。 
回 Y: 以 设备 当前 位 置 为 切 点 的 地 球 切 线 ， 指 向 地 磁 北极 。 z 
М 7: 与 地 平面 垂直 ， 指 向 天 空 。 


13.1.2 实战 演练 一 -确定 设备 当前 的 方向 muq ииненин» 
本 实例 联合 使 用 了 旋转 向 量 传感器 、 磁 场 传感器 、 重 力 传感器 和 加 速度 传感器 ， 功 能 是 获取 当前 
设备 的 方向 。 


本 实例 的 功能 是 当 设备 接近 某 个 位 置 时 实现 自动 提醒 。 本 实例 源码 是 开源 代码 , 来 源 于 地 址 https:// 

github.com/gast-lib/gast-lib/， 读 者 可 以 自行 登录 并 下 载 。 
(1) 实现 主 Activity 

本 实例 的 主 Activity 是 DetermineOrientationActivity， 通 过 布局 文件 determine_orientation.xml 实现 
布局 ， 在 屏幕 中 提供 一 组 单 选 按钮 供用 户 选择 所 需要 的 传感器 ， 并 在 屏幕 下 方 显示 传感器 返回 的 数据 。 
布局 文件 determine. orientation.xml 的 具体 实现 代码 如 下 : 

<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 

android:layout width-"match parent" 


android:layout height-"match parent" 
android:orientation-"vertical" > 


<RadioGroup android:id="@+id/sensorSelector" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout alignParentTop-"true" > 


«RadioButton android:id="@+id/gravitySensor" 
android:layout width-"match parent" 
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android:layout height-"wrap content" 
android:text="@string/gravitySensorLabel" 
android:checked-"true" 
android:onClick-"onSensorSelectorClick" /> 


<RadioButton android:id-"(g)*id/accelerometerMagnetometer" 
android:layout, width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/accelerometerMagnetometerLabel" 
android:checked-"false" 
android:onClick-"onSensorSelectorClick" /> 


<RadioButton android:id="@+id/gravityMagnetometer" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/gravityMagnetometerLabel" 
android:checked="false" 
android:onClick="onSensorSelectorClick" /> 


<RadioButton android:id="@+id/rotationVector" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/rotationVectorLabel" 
android:checked="false" 
android:onClick-"onSensorSelectorClick" /> 
</RadioGroup> 


<ToggleButton android:id="@+id/ttsNotifications ToggleButton" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"string/speakOrientationLabel" 
android:checked-"true" 
android:layout_below="@id/sensorSelector" 
android:textOn="@string/ttsNotificationsOn" 
android:textOff="@string/ttsNotificationsOff" 
android:onClick="onTtsNotifications ToggleButtonClicked" /> 


<TextView android:id="@+id/selectedSensorLabel" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:text="@string/selectedSensorLabel" 
android:layout_below="@id/ttsNotificationsToggleButton" 
android:layout_marginRight="5dip" /> 


<TextView android:id="@+id/selectedSensorValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_toRightOf="@id/selectedSensorLabel" 
android:layout_alignTop="@id/selectedSensorLabel” 
android:layout_alignBottom="@id/selectedSensorLabel" /> 
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«TextView android:id="@+id/orientationLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/orientationLabel” 
android:layout_below="@id/selectedSensorValue” 
android:layout_marginRight="5dip" /> 


<TextView android:id="@+id/orientationValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_toRightOf="@id/orientationLabel" 
android:layout_alignTop="@id/orientationLabel" 
android:layout_alignBottom="@id/orientationLabel" /> 


<TextView android:id="@+id/sensorXLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout below-"(giid/orientationValue" 
android:layout marginRight-"5dip" /> 


<TextView android:id="@+id/sensorXValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_toRightOf="@id/sensorXLabel" 
android:layout_alignTop="@id/sensorXLabel" 
android:layout_alignBottom="@id/sensorXLabel" /> 


«TextView android:id="@+id/sensorYLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_below="@id/sensorXLabel" 
android:layout marginRight-"5dip" /> 


<TextView android:id="@+id/sensorY Value" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout_toRightOf="@id/sensorYLabel" 
android:layout_alignTop="@id/sensorYLabel" 
android:layout_alignBottom="@id/sensorY Label" /> 


<TextView android:id="@+id/sensorZLabel" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout below-"(gid/sensorYLabel" 
android:layout marginRight-"5dip" /> 


«TextView android:id="@+id/sensorZValue" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_toRightOf="@id/sensorZLabel" 
android:layout_alignTop="@id/sensorZLabel" 
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android:layout_alignBottom="@id/sensorZLabel" /> 
</RelativeLayout> 


Ж Activity 程序 文件 DetermineOrientationActivity.java 的 功能 是 获取 SensorManager 的 引用 ， 根 据 
户 单 选 按钮 的 选择 来 注册 这 个 传感器 ， 然 后 调用 这 个 传感器 来 获取 数据 。 假 如 选择 的 是 重力 传感器 ， 
会 注册 重力 传感器 ， 然 后 获取 数组 SensorEvent.Values HH X. Y £l Z fili ЕН 大 小 。 当 选择 使 用 


Ж 


旋转 向 量 传感器 时 ， 会 调用 方法 determineOrientation(rotationMatrix) 根 据 给 出 的 旋转 和 矩阵 计算 出 具体 的 
方向 。 当 使 用 者 确定 了 设备 的 具体 朝向 时 ， 会 使 用 文本 转 语音 的 功能 来 提醒 用 户 。 本 实例 的 语音 提醒 
功能 是 通过 TTS 机 制 实现 的 ， 有 关 语 音 提醒 方面 的 知识 将 在 本 书后 面 的 章节 中 进行 详细 讲解 。 文 件 
DetermineOrientationActivity.java 的 具体 实现 代码 如 下 : 


protected void onCreate(Bundle savedinstanceState) 

{ 
super.onCreate(savedinstanceState); 
super.setContentView(R.layout.determine_orientation); 


getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON); 


ttsParams = new HashMap<String, String>(); 
ttsParams.put(Engine.KEY PARAM STREAM, String.valueOf(TTS STREAM)); 


this.setVolumeControlStream(TTS STREAM); 
sensorManager = (SensorManager) getSystemService(SENSOR SERVICE); 


sensorSelector = (RadioGroup) findViewByld(R.id.sensorSelector); 
selectedSensorValue = (TextView) findViewByld(R.id.selectedSensorValue); 
orientationValue = (TextView) findViewByld(R.id.orientationValue); 
sensorXLabel = (TextView) findViewByld(R.id.sensorXLabel); 
sensorXValue = (TextView) findViewById(R.id.sensorXValue); 
sensorYLabel = (TextView) findViewById(R.id.sensorYLabel); 
sensorYValue = (TextView) findViewById(R.id.sensorY Value); 
sensorZLabel = (TextView) findViewByld(R.id.sensorZLabel); 
sensorZValue = (TextView) findViewByld(R.id.sensorZValue); 
ttsNotifications ToggleButton = 

(ToggleButton) findViewByld(R.id.ttsNotificationsToggleButton); 


preferences = getPreferences(«MODE PRIVATE); 
ttsNotifications = 
preferences.getBoolean(TTS NOTIFICATION PREFERENCES KEY, true); 
} 


@Override 
protected void onResume() 


{ 


super.onResume(); 


ttsNotifications ToggleButton.setChecked(ttsNotifications); 
updateSelectedSensor(); 


б 


第 13 章 旋转 向 量 传感器 、 距 离 传感器 和 气压 传感器 


@Override 
protected void onPause() 


{ 


super.onPause(); 


sensorManager.unregisterListener(this); 


if (tts != null) 
{ 
tts.shutdown(); 
} 
} 
@Override 


public void onSensorChanged(SensorEvent event) 
float[] rotationMatrix; 


switch (event.sensor.getType()) 
{ 
case Sensor. TYPE_GRAVITY: 
sensorXLabel.setText(R.string.xAxisLabel); 
sensorXValue.setText(String.valueOf(event.values[0])); 


sensorYLabel.setText(R.string.yAxisLabel); 
sensorYValue.setText(String.valueOf(event.values[1])); 


sensorZLabel.setText(R.string.zAxisLabel); 
sensorZValue.setText(String.valueOf(event.values[2])); 


sensorYLabel.setVisibility(View. VISIBLE); 
sensorY Value.setVisibility(View. VISIBLE); 
sensorZLabel.setVisibility(View. VISIBLE); 
sensorZValue.setVisibility(View. VISIBLE); 


if (selectedSensorld == R.id.gravitySensor) 


{ 
if (event.values[2] >= GRAVITY_THRESHOLD) 
onFaceUp(); 
} 
else if (event.values[2] <= (GRAVITY_THRESHOLD * -1)) 
{ 
onFaceDown(); 
} 
} 
else 
Í 


accelerationValues = event.values.clone(); 
rotationMatrix = generateRotationMatrix(); 
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if (rotationMatrix != null) 


{ 
determineOrientation(rotationMatrix); 
D 
) 
break; 


case Sensor. TYPE ACCELEROMETER: 
accelerationValues = event.values.clone(); 
rotationMatrix = generateRotationMatrix(); 


if (rotationMatrix != null) 


determineOrientation(rotationMatrix); 
} 
һгеак; 
case Sensor. TYPE_MAGNETIC_FIELD: 
magneticValues = event.values.clone(); 
rotationMatrix = generateRotationMatrix(); 


if (rotationMatrix != null) 


determineOrientation(rotationMatrix); 
} 
break; 
case Sensor. TYPE ROTATION VECTOR: 


rotationMatrix = new float[16]; 
SensorManager.getRotationMatrixFromVector(rotationMatrix, 


event.values); 
determineOrientation(rotationMatrix); 
break; 
} 
} 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) 
{ 
Log.d(TAG, 
String.format("Accuracy for sensor %s = %d", 
sensor.getName(), accuracy)); 
} 
private float[] generateRotationMatrix() 
{ 


float[] rotationMatrix = null; 


if (accelerationValues != null && magneticValues != null) 
{ 
rotationMatrix = new float[16]; 
boolean rotationMatrixGenerated; 
rotationMatrixGenerated = 
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SensorManager.getRotationMatrix(rotationMatrix, 
null, 

accelerationValues, 

magneticValues); 


if (!rotationMatrixGenerated) 


{ 
Log.w(TAG, getString(R.string.rotationMatrixGenFailureMessage)); 


rotationMatrix = null; 


} 


return rotationMatrix; 


} 


p 
“使 用 最 后 一 个 读 取 加 速度 和 重力 的 值 ， 以 确定 
“设备 是 正面 朝 上 还 是 朝 下 


* @param rotationMatrix The rotation matrix to use if the orientation 
* calculation 
*l 
private void determineOrientation(float[] rotationMatrix) 
{ 
float[] orientationValues = new float[3]; 
SensorManager.getOrientation(rotationMatrix, orientationValues); 


double azimuth = Math.toDegrees(orientationValues[0]); 
double pitch = Math.toDegrees(orientationValues[1]); 
double roll  Math.toDegrees(orientationValues[2]); 


sensorXLabel.setText(R.string.azimuthLabel); 
sensorXValue.setText(String.valueOf(azimuth)); 


sensorYLabel.setText(R.string.pitchLabel); 
sensorYValue.setText(String.valueOf(pitch)); 


sensorZLabel.setText(R.string.rollLabel); 
sensorZValue.setText(String.valueOf(roll)); 


sensorYLabel.setVisibility(View. VISIBLE); 
sensorY Value.setVisibility(View. VISIBLE); 
sensorZLabel.setVisibility(View. VISIBLE); 
sensorZValue.setVisibility(View. VISIBLE); 


if (pitch <= 10) 
{ 
if (Math.abs(roll) >= 170) 
{ 


onFaceDown(); 
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) 
else if (Math.abs(roll) <= 10) 
{ 
onFaceUp(); 
} 
} 
} 
n 
* 处 理 程序 设备 是 正面 朝 上 


ч 
private void onFaceUp() 


if (lisFaceUp) 


if (tts != null && ttsNotifications ToggleButton.isChecked()) 


{ 
tts.speak(getString(R.string.faceUpText), 
TextToSpeech.QUEUE_FLUSH, 
ttsParams); 


} 


orientationValue.setText(R.string.faceUpText); 
isFaceUp = true; 


} 


p 
* Handler for device being face down 
Hl 

private void onFaceDown() 


if (isFaceUp) 


if (tts != null && ttsNotificationsToggleButton.isChecked()) 


{ 
tts.speak(getString(R.string.faceDownText), 
TextToSpeech.QUEUE_FLUSH, 
ttsParams); 


} 


orientationValue.setText(R.string.faceDownText); 
isFaceUp - false; 


} 


p 
* Updates the views for when the selected sensor is changed 
A 

private void updateSelectedSensor() 
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sensorManager.unregisterListener(this); 


selectedSensorld = sensorSelector.getCheckedRadioButtonld(); 
if (selectedSensorld == R.id.accelerometerMagnetometer) 
Í 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE ACCELEROMETER), 
RATE); 


sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE MAGNETIC FIELD), 
RATE); 


else if (selectedSensorld == R.id.gravityMagnetometer) 
{ 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE GRAVITY), 
RATE); 


sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE MAGNETIC FIELD), 


RATE); 
else if ((selectedSensorld == R.id.gravitySensor)) 
{ 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE GRAVITY), 
RATE); 
} 
else 
{ 
sensorManager.registerListener(this, 
sensorManager.getDefaultSensor(Sensor.TYPE ROTATION VECTOR), 
RATE); 
} 


RadioButton selectedSensorRadioButton = 
(RadioButton) findViewByld(selectedSensorld); 
selectedSensorValue.setText(selectedSensorRadioButton.getText()); 


} 


p 
* Handles click event for the sensor selector 


* 


* (param view The view that was clicked 
ell 
public void onSensorSelectorClick(View view) 


{ 
} 


updateSelectedSensor(); 
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} 


p 
* Handles click event for the TTS toggle button 
* @param view The view for the toggle button 
“fl 
public void onTtsNotificationsToggleButtonClicked(View view) 
{ 
ttsNotifications = ((ToggleButton) view).isChecked(); 
preferences.edit() 
.putBoolean(TTS NOTIFICATION PREFERENCES KEY, ttsNotifications) 
.commit(); 


) 


@Override 
public void onSuccessfullnit(TextToSpeech tts) 
{ 
super.onSuccessfullnit(tts); 
this.tts = tts; 
} 


@Override 

protected void receiveWhatWasHeard(List<String> heard, float[] confidenceScores) 
{ 

} 


(2) 获取 设备 的 旋转 向 量 


编写 文件 NorthFinderjava， 首 先 获 取 设 备 的 旋转 向 量 ， 并 将 旋转 向 量 的 坐标 映射 到 摄像 头 的 轴 上 。 
如 果 取 消 了 对 方法 remapCoordinateSystem 的 调用 ， 则 将 当前 设备 指向 北方 ， 而 并 不 是 将 后 置 摄像 头 指 
向 北方 。 除 此 之 外 ， 在 此 文件 中 还 使 用 OpenGL 改变 了 屏幕 的 颜色 ， 当 后 置 摄像 头 指向 北方 时 《允许 
误差 20” 以 内 )， 将 屏幕 颜色 从 红色 变 为 绿色 。 文 件 NorthFinderjava 的 具体 实现 代码 如 下 : 


public class NorthFinder extends Activity implements SensorEventListener 


{ 


private static final int ANGLE = 20; 


private TextView tv; 

private GLSurfaceView mGLSurfaceView; 
private MyRenderer mRenderer; 

private SensorManager mSensorManager; 
private Sensor mRotVectSensor; 

private float[] orientationVals = new float[3]; 


private final float[] mRotationMatrix = new float[16]; 
@Override 

protected void onCreate(Bundle savedinstanceState) 
{ 


super.onCreate(savedinstanceState); 


setContentView(R.layout.sensors_north_main); 
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mRenderer = new MyRenderer(); 
mGLSurfaceView = (GLSurfaceView) findViewByld(R.id.glsurfaceview); 
mGLSurfaceView.setRenderer(mRenderer); 


tv = (TextView) findViewByld(R.id.tv); 
mSensorManager = (SensorManager) getSystemService(SENSOR_SERVICE); 


mRotVectSensor = 
mSensorManager.getDefaultSensor(Sensor. TYPE ROTATION VECTOR); 


) 
@Override 
protected void onResume() 
{ 
super.onResume(); 
mSensorManager.registerListener(this, mRotVectSensor, 10000); 
} 
@Override 
protected void onPause() 
{ 
super.onPause(); 
mSensorManager.unregisterListener(this); 
} 
@Override 
public void onSensorChanged(SensorEvent event) 
{ 
if (event.sensor.getType() == Sensor. TYPE_ROTATION_VECTOR) 
{ 
SensorManager.getRotationMatrixFromVector(mRotationMatrix, 
event.values); 
SensorManager 
.remapCoordinateSystem(mRotationMatrix, 
SensorManager.AXIS X, SensorManager.AXIS Z, 
mRotationMatrix); 
SensorManager.getOrientation(mRotationMatrix, orientationVals); 
orientationVals[0] = (float) Math.toDegrees(orientationVals[0]); 
orientationVals[1] = (float) Math.toDegrees(orientationVals[1]); 
orientationVals[2] = (float) Math.toDegrees(orientationVals[2]); 
tv.setText(" Yaw: " + orientationVals[0] + ^n Pitch: " 
+ orientationVals[1] + "\n Roll (not used): " 
+ orientationVals[2]); 
} 
} 
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@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) 
{ 
} 
class MyRenderer implements GLSurfaceView.Renderer 
{ 
public void onDrawFrame(GL10 gl) 
gl.glClear(GL10.GL_COLOR_BUFFER_BIT); 
if (orientationVals[0] < ANGLE && orientationVals[0] > -ANGLE 
&& orientationVals[1] < ANGLE 
&& orientationVals[1] > -ANGLE) 
gl.giClearColor(0, 1, 0, 1); 
} 
else 
gl.giClearColor(1, 0, 0, 1); 
} 
} 
@Override 
public void onSurfaceChanged(GL10 gl, int width, int height) 
{ 
} 
@Override 
public void onSurfaceCreated(GL10 gl, EGLConfig config) 
{ 
} 
} 


} 


至 此 ， 整 个 实例 的 核心 代码 介绍 完毕 。 为 节省 本 书 篇 幅 ， 其 余 的 代码 将 不 再 进行 详细 讲解 。 


132 ”距离 传感器 详解 


Ши 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 13 章 \ 距 离 传感器 详解 .avi 


在 Android 设备 应 用 程序 开发 过 程 中 ， 通 过 使 用 距离 传感器 可 以 测试 设备 的 移动 距离 。 本 节 将 详 


细 讲 解 在 Android 设备 中 使 用 距离 传感器 检测 运动 数据 的 基本 知识 。 
13.2.1 距离 传感器 介绍 


在 Android 系统 中 ， 需 要 使 用 加 速度 传感器 、 线 性 加 速度 传感器 和 距离 传感器 来 检测 设备 的 运动 


数据 。 在 当前 的 技术 条 件 下 ， 距 离 传感器 是 指 利用 “飞行 时 间 法 ”(Flying Time) 的 原 到 
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离 ， 以 实现 检测 物体 距离 的 一 种 传感器 .“ 飞 行 时 间 法 ”(Flying Time) 是 通过 发 射 特别 短 的 光 脉 冲 ， 
并 测量 此 光 脉 冲 从 发 射 到 被 物体 反射 回来 的 时 间 ， 通 过 测量 时 间 间 隔 来 计算 与 物体 之 间 的 距离 。 

在 现实 世界 中 ， 距 离 传感器 在 智能 手机 中 的 应 用 比较 常见 。 一 般 触 屏 智 能 手机 在 默认 设置 下 都 会 
有 一 个 延 时 锁 屏 的 设置 ， 就 是 在 一 段 时 间 内 ， 手 机 检测 不 到 任何 操作 ， 就 会 进入 锁 屏 状态 。 这 样 是 有 
一 定好 处 的 。 手 机 作为 移动 终端 的 一 种 ， 追 求 低 功 耗 是 设计 的 目标 之 一 。 延 时 锁 屏 既 可 以 避免 不 必要 
的 能 量 消耗 ， 又 能 保证 不 丢失 重要 信息 。 另 外 ， 在 使 用 触 屏 手机 设备 时 ， 当 接 电话 时 距离 传感器 会 起 
作用 ， 当 脸 靠近 屏幕 时 屏幕 灯会 煌 灭 ， 并 自动 锁 屏 ， 这 样 可 以 防止 脸 误 操作 。 当 脸 离开 屏幕 时 屏幕 灯 
会 自动 开启 ， 并 且 自 动 解锁 。 

除了 被 广泛 应 用 于 手机 设备 之 外 ， 距 离 传感器 还 被 用 于 野外 环境 〈 山 体 情 况 、 峡 谷 深度 等 )、 飞 机 
高 度 检测 、 矿 井深 度 、 物 料 高 度 测量 等 领域 。 并 且 在 野外 应 用 领域 中 ， 主 要 用 于 检测 山体 情况 和 峡谷 
深度 等 。 而 对 飞机 高 度 测量 功能 是 通过 检测 飞机 在 起 飞 后 和 降落 至 地 面 之 前 时 距离 地 面 的 高 度 ， 并 将 
结果 实时 显示 在 控制 面板 上 。 也 可 以 使 用 距离 传感器 测量 物料 各 点 高 度 ， 用 于 计算 物料 的 体积 。 在 显 
示 应 用 中 ， 用 于 飞机 高 度 和 物料 高 度 的 距离 传感器 有 LDM301 系列 ， 用 于 野外 应 用 的 距离 传感器 有 
LDM4x 系列 。 

在 当前 的 物 联网 设备 应 用 中 ， 距 离 传感器 被 应 用 于 智能 皮带 中 。 在 皮带 扣 中 嵌入 了 距离 传感器 ， 
当 把 皮带 调整 至 合适 宽度 、 卡 好 皮带 扣 后 ， 如 果皮 带 在 10 秒 钟 内 没有 重新 解 开 ， 传 感 器 就 会 自动 生成 
本 次 的 腰围 数据 。 皮 带 与 皮带 扣 连 接 处 的 其 中 一 枚 锦 钉 将 被 数据 传输 装置 所 替代 。 当 将 智能 手机 放 在 
锦 钉 处 保持 两 秒 钟 静止 ， 手 机 中 的 自我 健康 管理 App 会 被 自动 激活 ， 并 获取 本 次 腰围 数据 。 


13.2.2 Android 系统 中 的 距离 传感器 


在 Android 系统 中 ， 距 离 传感器 也 被 称 为 P-Sensor， 值 是 TYPE_PROXIMITY， 单 位 是 ecm， 能 够 
测量 某 个 对 象 到 屏幕 的 距离 。 可 以 在 打 电 话 时 判断 人 耳 到 电话 屏幕 的 距离 ， 以 关闭 屏幕 而 达到 省 电 功 能 。 
P-Sensor 主要 用 于 在 通话 过 程 中 防止 用 户 误 操作 屏幕 ， 接 下 来 以 通话 过 程 为 例 来 讲解 电话 程序 对 
P-Sensor 的 操作 流程 。 
COD 在 启动 电话 程序 时 , 在 .java 文件 中 新 建 了 一 个 P-Sensor 的 wakeLock XJ t. 例如 下 面 的 代码 。 
mProximityWakeLock = pm.newWakeLock( 
PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK, LOG TAG 
); 
对 象 wakeLock (YL HEAL iw КТЕ EEA KA TEBE K, 
(2) 在 电话 状态 发 生 改 变 时 ， 例 如 接 通 了 电话 ， 调 用 .java 文件 中 的 方法 根据 当前 电话 的 状态 来 决 
定 是 否 打开 P-Sensor。 如 果 在 通话 过 程 中 ， 电 话 是 OFF-HOOK 状态 时 打开 P-Sensor。 例 如 下 面 的 演示 
代码 。 
if (ImProximityWakeLock.isHeld()) { 
if (DBG) Log.d(LOG TAG, "updateProximitySensorMode: acquiring..."); 
mProximityWakeLock.acquire(); 


} 
在 上 述 代 码 中 ，mProximityWakeLock.acquireO 会 调用 到 另外 的 方法 打开 P-Sensor， 这 个 另外 的 方 
法 会 判断 当前 手机 有 没有 P-Sensor。 如 果 有 ， 就 会 向 SensorManager 注册 一 个 P-Sensor 监听 器 。 这 样 当 
P-Sensor 检测 到 手机 和 人 体 距 离 发 生 改 变 时 ， 就 会 调用 服务 监听 器 进行 处 理 。 同 样 ， 当 电话 挂 断 时 ， 
电话 模块 会 去 调用 方法 取消 P-Sensor 监听 器 。 
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在 Android 系统 中 ，PowerManagerService 中 的 P-Sensor 监听 器 会 进行 实时 监听 工作 ， 当 P-Sensor 
检测 到 距离 有 变化 时 就 会 进行 监听 。 具 体 监听 过 程 的 代码 如 下 : 
SensorEventListener mProximityListener = new SensorEventListener() { 
public void onSensorChanged(SensorEvent event) { 
long milliseconds = SystemClock.elapsedRealtime(); 
synchronized (mLocks) { 
float distance = event.values[0]; /检测 到 手机 和 人 体 的 距离 
long timeSinceLastEvent = milliseconds - mLastProximityEventTime; /这 次 检测 和 上 次 检测 
的 时 间 差 
mLastProximityEventTime = milliseconds; /更 新 上 一 次 检测 的 时 间 
mHandler.removeCallbacks(mProximityTask); 
boolean proximityTaskQueued - false; 


//compare against getMaximumRange to support sensors that only return 0 or 1 
boolean active = (distance >= 0.0 && distance « PROXIMITY THRESHOLD && 
distance < mProximitySensor.getMaximumRange(); /如 果 距 离 小 于 某 一 个 距离 阔 
值 ， 默 认 是 5.0f， 说 明 手机 和 脸 部 距离 贴近 ， 应 该 熄灭 屏幕 


if (mDebugProximitySensor) { 
Slog.d(TAG, "mProximityListener.onSensorChanged active: " + active); 
} 
if (timeSinceLastEvent < PROXIMITY_SENSOR_DELAY) { 
mProximityPendingValue = (active ? 1 : 0); 
mHandler.postDelayed(mProximityTask, PROXIMITY SENSOR DELAY - timeSinceLast 


Event); 
proximityTaskQueued = true; 
}else { 
mProximityPendingValue = -1; 
proximityChangedLocked(active); /熄灭 屏幕 操作 
} 


boolean held = mProximityPartialLock.isHeld(); 

if (Iheld && proximityTaskQueued) { 
mProximityPartialLock.acquire(); 

} else if (held && !proximityTaskQueued) { 
mProximityPartialLock.release(); 

} 


} 


public void onAccuracyChanged(Sensor sensor, int accuracy) { 


} 


Е 
由 上 述 代码 可 知 ， 在 监听 时 会 首先 通过 float distance = eventvalues[0]: 获 取 变 化 的 距离 。 如 果 发 现 
检测 这 次 距离 变化 和 上 次 距离 变化 时 间 差 ， 例 如 小 于 系统 设置 的 阔 值 则 不 会 去 熄灭 屏幕 。 过 于 频繁 的 
操作 系统 会 忽略 掉 。 如 果 感 觉 P-Sensor 不 够 灵敏 ， 就 可 以 修改 如 下 所 示 的 系统 默认 值 。 
private static final int PROXIMITY_SENSOR_DELAY = 1000; 
将 上 述 值 改 小 后 就 会 发 现 P-Sensor 会 变 得 灵敏 很 多 。 
如 果 P-Sensor 检测 到 这 次 距离 变化 小 于 系统 默认 值 ， 并 且 这 次 是 一 次 正常 的 变化 ， 那 么 需要 通过 
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如 下 代码 熄灭 屏幕 。 
proximityChangedLocked(active); 
此 处 会 判断 P-Sensor 是 否 可 以 用 ， 如 果 不 可 用 则 返回 ， 并 忽略 这 次 距离 变化 。 
if (ImProximitySensorEnabled) { 
Slog.d(TAG, "Ignoring proximity change after sensor is disabled"); 
return; 


} 
如 果 一 切 都 满足 ， 则 调用 如 下 代码 灭 灯 。 
goToSleepLocked(SystemClock.uptimeMillis(), 
WindowManagerPolicy.OFF_BECAUSE_OF_PROX_SENSOR); 


13.2.3 ”实战 演练 一 一 实现 自动 锁 屏 功能 


在 当前 的 Android 智能 设备 中 ， 特 别 是 触 屏 智能 手机 设备 ， 在 默认 设置 下 都 会 有 一 个 延 时 锁 屏 的 
功能 ， 通 过 此 功能 设置 后 ， 如 果 在 一 段 时 间 内 设置 手机 检测 不 到 任何 操作 ， 手 机 会 自动 进入 锁 屏 状态 。 
通过 延 时 锁 屏 功能 ， 不 但 可 以 避免 不 必要 的 能 量 消耗 ， 而 且 又 能 保证 不 丢失 重要 的 信息 。 


本 实例 的 功能 是 使 用 距离 传感器 实现 自动 锁 屏 功能 ， 具 体 实现 流程 如 下 所 示 。 
(1) 编写 布局 文件 activity_main.xml， 功 能 是 在 屏幕 中 分 别 设置 “启动 服务 `“ 停 止 服务 ”和 “ 退 
出 ”3 个 按钮 ， 具 体 实现 代码 如 下 : 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmins:tools="http://schemas.android.com/tools” 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:paddingBottom-"(gdimen/activity vertical margin" 
android:paddingLeft-"(dimen/activity horizontal margin" 
android:paddingRight-"(Qdimen/activity horizontal margin" 
android:paddingTop-"(dimen/activity vertical margin" 
tools:context-" MainActivity" > 


«TextView 
android:id="@+id/title_tv" 
android:layout centerHorizontal-' yl 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize="20sp" 
android:text="@string/title" /> 


<Button 
android:id="@+id/start" 
android:layout_below="@id/title_tv" 
android:layout_centerHorizontal="true" 
android:layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:textSize-"20sp" 
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android:text="@string/start" /> 


<Button 
android:id="@+id/stop" 
android:layout_below="@id/start" 
android:layout_centerHorizontal="true" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:textSize="20sp" 
android:text="@string/stop" /> 


<Button 
android:id="@+id/exit" 
android:layout_below="@id/stop" 
android:layout centerHorizontal-"true" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:textSize="20sp" 
android:text="@string/exit" /> 


<TextView 
android:id="@+id/sensortitle_tv" 
android:layout_below="@id/exit" 
android:layout_centerHorizontal="true" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize="20sp" 
android:text="@string/sensorinfo" /> 


<TextView 
android:id="@+id/sensorinfo_tv" 
android:layout_below="@id/sensortitle_tv" 
android:layout_centerHorizontal="true" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:textSize="20sp" 
android:text="@string/sensorinfo" /> 
</RelativeLayout> 


(2) 编写 文件 MainActivityjava， 在 启动 时 显示 传感器 名 和 版 本 号 ， 


对 应 的 事件 处 理 程序 。 文 件 MainActivity.java 的 具体 实现 代码 如 下 : 
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public class MainActivity extends Activity { 


private Button start; 

private Button stop; 

private Button exit; 

private TextView sensorinfo_tv; 
private Intent intent; 

private SensorManager sm = null; 
private Sensor promixty = null; 


并 根据 用 户 的 按钮 操作 执行 


第 13 章 旋转 向 量 传感器 、 距 离 传感器 和 气压 传感器 


@Override 
protected void onCreate(Bundle savedinstanceState) { 


} 


super.onCreate(savedinstanceState); 
setContentView(R.layout.activity main); 
if (null == sm) ( 
sm = (SensorManager) getSystemService(SENSOR SERVICE); /获取 传感器 管理 类 
promixty = sm.getDefaultSensor(Sensor.TYPE PROXIMITY); // 获 取 距 离 传感器 
} 
String sensorinfo; 
if (null != promixty) { 
sensorinfo = "传感器 名 称 : " + promixty.getName() + "n" 
+ "设备 版 本 : "+ promixty.getVersion() + "n" + "供应 商 :" 


+ promixty.getVendor() + "\n"; 
} 
else { 
sensorinfo = "无 法 获取 距离 传感器 信息 ， 可 能 是 您 的 手机 不 支持 该 传感器 。"; 
} 
initUl(); 


intent = new Intent("org.hq.autoLockService"); 
start.setOnClickListener( new OnClickListener() { 
@Override 
public void onClick(View v) { 
/开启 服务 
start(); 


} 
}); 
stop.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
/停止 服务 
stop(); 
} 
» 
exit.setOnClickListener( new OnClickListener() ( 


@Override 
public void onClick(View v) { 
/结束 本 次 Activity 
finish(); 
1 
}; 


sensorinfo tv.setText(sensorlnfo); 


private void initUI()( 


start = (Button) super.findViewByld(R.id.start); 

stop = (Button) super.findViewByld(R.id.stop); 

exit = (Button) super.findViewByld(R.id-exit); 

sensorinfo tv = (TextView) super.findViewByld(R.id.sensorinfo_tv); 
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private void start(){ 
Bundle bundle = new Bundle(); 
bundle.putint("distance", 3); 
bundle.putBoolean("activited", true); 
intent.putExtras(bundle); 
startService(intent); 
/| 结束 本 次 Activity 
//finish(); 


} 
/| 终止 服务 
private void stop(){ 
stopService(intent); 
Toast.makeText(this, "已 停止 后 台 服 务 。", Toast.LENGTH_SHORT).show(); 


} 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.main, menu); 
return true; 


) 
(3) 编写 文件 AutoLockService.java 实现 自动 锁 屏 服务 ， 通 过 距离 传感器 来 监听 距离 ， 自 动 进入 
锁 屏 状态 。 文 件 AutoLockService.java 的 具体 实现 代码 如 下 : 
public class AutoLockService extends Service implements SensorEventListener { 


private SensorManager sm = null; 
private Sensor promixty = null; 

// 默 认 启用 锁 屏 

private static boolean ACTIVITED = true; 
// 锁 屏 距离 〈 单 位 : EX) 

private static intLOCK_DIST = 3; 


@Override 
public IBinder onBind(Intent intent) { 
return null; 


} 


@Override 
public void onCreate() { 
super.onCreate(); 
if (null == sm) { 
sm = (SensorManager) getSystemService(SENSOR_SERVICE); /获取 传感器 管理 类 
promixty = sm.getDefaultSensor(Sensor.TYPE PROXIMITY); // 获 取 距 离 传感器 


» 
/显示 距离 传感器 信息 
if (null != promixty) { 
Toast.makeText(this, "已 创建 后 台 服 务 。", Toast.LENGTH_SHORT).show(); 
) else { 
Toast.makeText(this, "无 法 找到 距离 传感器 ", Toast.LENGTH_SHORT).show(); 
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} 
j 
@Override 
public void onDestroy() { 
super.onDestroy(); 
if( null != sm X 
/撤销 监听 器 
sm.unregisterListener(this); 
} 
} 
@Override 


public void onStart(Intent intent, int startld) { 
if (intent != null) { 
Bundle bundle = intent.getExtras(); 
Toast.makeText(this, "后 台 服务 已 启动 。", Toast.LENGTH_SHORT).show(); 
// 从 Intent 中 获取 设置 参数 
if (bundle != null) { 
int dist = bundle.getInt("distance"); 
ACTIVITED = bundle.getBoolean("activited"); 
if (dist > 0 && dist < 9) { 
LOCK_DIST = dist; 
} 


} 
/注册 监听 器 
sm.registerListener(this, promixty,SensorManager.SENSOR_DELAY_NORMAL); 


} 


/监听 精度 变化 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
Toast.makeText(this, "距离 传感器 promixty 精度 变 为 " + accuracy, 
Toast.LENGTH_SHORT).show(); 


} 


@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.values[0] < LOCK DIST) /距离 小 于 5, SiRF 


{ 
if (ACTIVITED) { 
lockScreen(); 
} 
} 
} 
// 跳 至 锁 屏 页 面 


private void lockScreen() { 
Intent intent = new Intent(); 
/在 Activity 之 外 启动 ， 要 加 上 FLAG_ACTIVITY_NEW_TASK flag 
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intent.setFlags( Intent.FLAG ACTIVITY NEW TASK ); 
intent.setClass(this, LockScreen.Controller.class); 
startActivity(intent); 
) 
) 
(4) 编写 文件 LockScreen.java， 功 能 是 实现 锁 屏 功能 ， 在 锁 屏 之 前 需要 先 获取 锁 屏 权限 。 文 件 


LockScreen.java 的 具体 实现 代码 如 下 : 
public class LockScreen extends DeviceAdminReceiver { 
static final int RESULT_ENABLE = 1; 


public static class Controller extends Activity { 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 


@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 


// 首 先 要 获得 Android 设备 管理 代理 
mDPM = (DevicePolicyManager) getSystemService(Context.DEVICE_POLICY_SERVICE); 


llLockScreen 继承 自 DeviceAdminReceiver 
mDeviceAdminSample = new ComponentName(Controller.this, 
LockScreen.class); 
/得 到 当前 设备 管理 器 有 没有 激活 
boolean active = mDPM.isAdminActive(mDeviceAdminSample); 
if (lactive) { 
/如果 没有 激活 ， 就 去 提示 用 户 激活 〈 第 一 次 运行 程序 时 ) 
getAdmin(); 
}else{ 
// 如 果 已 经 激活 ， 就 执行 立即 锁 屏 
mDPM.lockNow(); 


} 
// kilMyself， 锁 屏 之 后 就 立即 kill $8 Activity， 避 免 资源 的 浪费 
/landroid.os.Process.killProcess(android.os.Process.myPid()); 
finish(); 

} 


// 获 取 锁 屏 权限 
public void getAdmin() { 
Intent intent = new Intent( 
DevicePolicyManager.ACTION ADD DEVICE ADMIN); 
intent.putExtra(DevicePolicyManager.EXTRA DEVICE ADMIN, 
mDeviceAdminSample); 
intent.putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION, 
"欢迎 您 的 使 用 ! 在 第 一 次 使 用 时 ， 请 授予 该 程序 锁 屏 权限 。"); 
startActivityForResult(intent, RESULT_ENABLE); 
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(5) 在 文件 AndroidManifest.xml 中 声明 权限 ， 特 别 是 需要 注册 一 个 广播 接收 者 ， 有 具体 实现 代码 


如 下 : 
<l-- 注册 锁 屏 Activity --> 

«activity android:name="org.lock.LockScreen$Controller" > 
</activity> 


<service 
android:name-"org.lock.AutoLockService" 
android:permission-"android.permission.BIND ACCESSIBILITY SERVICE" 
android:enabled-"true" > 
<intent-filter> 
«action android:name="org.lock.autoLockService" /> 
</intent-filter> 
</service> 
«receiver 
android:name="org.lock.LockScreen” 
android:permission="android.permission.BIND_DEVICE_ADMIN" > 
<meta-data 
android:name-"android.app.device admin" 
android:resource-"(Qxml/device admin sample" /> 


<intent-filter> 
«action android:name-"android.app.action.DEVICE ADMIN ENABLED" /> 
</intent-filter> 
</receiver> 


至 此 ， 整 个 实例 介绍 完毕 ， 执 行 后 的 效果 如 图 13-2 所 示 。 


® AutoLock 


传感器 锁 屏 程序 
启动 服务 
停止 服务 
退出 


传感器 信息 : 
传感器 信息 : 


13-2 ”执行 效果 
133 ”和 气压 传感器 详解 


CE 知识 点 讲解 : AMAL ORAS 13 章 \ 气 压 传感器 详解 .avi 

在 Android 设备 开发 应 用 过 程 中 , 通常 需要 使 用 设备 来 感知 当前 所 处 环境 的 信息 , 例如 气压 、GPS、 
海拔 、 湿 度 和 温度 。 在 Android 系统 中 ， 专 门 提供 了 气压 传感器 、 海 拔 传感器 、 湿 度 传感器 和 温度 传 
感 器 来 支持 上 述 功 能 。 本 节 将 详细 讲解 在 Android 设备 中 使 用 气压 传感器 的 基本 知识 ， 为 读者 步 入 本 
书后 面 知 识 的 学 习 打 下 基础 。 
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1331 气压 传感器 基础 


在 现实 应 用 中 ， 气 压 传感器 主要 用 于 测量 气体 的 绝对 压强 ， 主 要 适用 于 与 气体 压强 相关 的 物理 实 
验 ， 如 气体 定律 等 ， 也 可 以 在 生物 和 化 学 实验 中 测量 干燥 、 无 腐蚀 性 的 气体 压强 。 气 压 传 感 器 的 原理 
比较 简单 ， 其 主要 的 传 感 元 件 是 一 个 对 气压 传感器 内 的 强 弱 敏感 的 薄膜 和 一 个 项 针 开 控制 ， 电 路 方面 
它 连 接 了 一 个 柔性 电阻 器 。 当 被 测 气体 的 压力 降低 或 升 高 时 ， 这 个 薄膜 变形 带动 项 针 ， 同 时 该 电阻 器 
的 阻 值 将 会 改变 。 从 传 感 元 件 取得 0 一 5V 的 信号 电压 ， 经 过 A/D 转换 由 数据 采集 器 接受 ， 然 后 数据 采 
集 器 以 适当 的 形式 把 结果 传送 给 计算 机 。 

在 现实 应 用 中 ， 很 多 气压 传感器 的 主要 部 件 为 变 容 式 硅 膜 盒 。 当 该 变 容 硅 膜 盒 外 界 大 气压 力 发 生 
变化 时 发 生 项 针 动 作 ， 而 单 唱 硅 膜 盒 会 随 着 发 生 弹 性 变形 ， 从 而 引起 硅 膜 盒 平行 板 电容 器 电容 量 的 变 
化 来 控制 气压 传感器 。 
国标 GB7665-87 对 传感器 的 定义 是 :“ 能 感受 规定 的 被 测量 并 按照 一 定 的 规律 转换 成 可 用 信号 的 器 
件 或 装置 , 通常 由 敏感 元 件 和 转换 元 件 组 成 ” 而 气压 传感器 是 一 种 检测 装置 , 能 感受 到 被 测量 的 信息 ， 
并 能 将 检测 感受 到 的 信息 按 一 定 规律 变换 成 为 电信 号 或 其 他 所 需 形式 的 信息 输出 ,以 满足 信息 的 传输 、 
处 理 、 存 储 、 显 示 、 记 录 和 控制 等 要 求 ， 是 实现 自动 化 检测 和 控制 的 首要 环节 。 


13.32 气压 传感器 在 智能 手机 中 的 应 用 


随 着 智能 手机 设备 的 发 展 ， 气 压 传感器 得 到 了 大 力 的 普及 。 和 气压 传 感 器 首次 在 智能 手机 上 使 用 是 
在 Galaxy Nexus 上 , 而 之 后 推出 的 一 些 Android 旗舰 手机 中 也 包含 了 这 一 传感器 , 像 Galaxy SIII. Galaxy 
Note2 也 都 有 。 对 于 喜欢 登山 的 人 来 说 ， 都 会 非常 关心 自己 所 处 的 高 度 。 海 拔高 度 的 测量 方法 ， 一 般 常 
用 的 有 两 种 方式 ， 一 是 通过 GPS 全 球 定位 系统 ， 二 是 通过 测 出 大 气压 ， 然 后 根据 气压 值 计 算出 海拔 高 
度 。 由 于 受到 技术 和 其 他 方面 原因 的 限制 ，GPS 计算 海拔 高 度 一 般 误 差 都 会 有 10 米 左 右 ， 而 如 果 在 树 
林 里 或 者 是 在 悬崖 下 面 ， 有 时 甚至 接收 不 到 GPS 卫星 信号 。 同 时 当 用 户 处 于 楼 宇内 时 ， 内 置 感应 器 可 
能 会 无 法 接收 到 GPS 信号 ， 从 而 不 能 够 识别 地 理 位 置 。 配 合 气压 传感器 、 加 速 计 、 陀 螺 仪 等 就 能 够 实 
现 精确 定位 。 这 样 当 用 户 在 商场 购物 时 ， 能 够 更 容易 地 找到 目标 商品 。 

另外 在 汽车 导航 领域 中 ， 经 常会 有 人 抱怨 在 高 架 桥 里 导航 会 出 错 。 例 如 在 高 架 桥 上 时 ，GPS 说 右 
转 ， 而 实际 上 右边 根本 没有 右 转 出 口 ， 这 主要 是 GPS 无 法 判断 用 户 是 在 桥 上 还 是 桥 下 而 造成 的 错误 导 
航 。 一 般 高 架 桥 上 下 两 层 的 高 度 都 会 有 几米 到 十 几米 的 距离 ， 而 GPS 的 误差 可 能 会 有 几 十 米 ， 所 以 发 
生 上 面 的 事情 也 就 可 以 理解 了 。 此 时 如 果 在 手机 中 增加 一 个 气压 传感器 就 不 一 样 了 ， 它 的 精度 可 以 做 
到 1 米 的 误差 ， 这样 就 可 以 很 好 地 辅助 GPS 来 测量 出 所 处 的 高 度 ， 错 误导 航 的 问题 也 就 容易 解决 了 。 

而 气压 的 方式 可 选择 的 范围 会 广 些 ， 而 且 可 以 把 成 本 控制 在 比较 低 的 水 平 。 另 外 像 Galaxy Nexus 
等 手机 的 气压 传感器 还 包括 温度 传感器 ， 它 可 以 捕捉 到 温度 来 对 结果 进行 修正 ， 以 增加 测量 结果 的 精 
度 。 所 以 在 手机 原 有 GPS 的 基础 上 再 增加 气压 传感器 的 功能 ， 可 以 让 三 维 定位 更 加 精准 。 

在 Android 系统 中 ， 气 压 传感器 的 类 型 是 ТҮРЕ PRESSURE， 单 位 是 hPa( 百 帕斯卡 )， 能 够 返回 
当前 环境 下 的 压强 。 


13.3.3 ”实战 演练 一 一 开发 一 个 Android 气压 计 


本 实例 将 详细 讲解 开发 一 个 Web 版 气压 测试 系统 的 方法 。 


e. 
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(1) 编写 插件 调用 文件 
编写 插件 调用 文件 plugin.xml， 具 体 代码 如 下 : 
<plugin xmins="http://apache.org/cordova/ns/plugins/1.0" 
id-"org.dartlang.phonegap.barometer" 
version="0.0.2"> 


<name>Device Barometer</name> 

<description>Cordova Device Barometer Plugin</description> 
<license>LICENSE</license> 
<keywords>cordova,device,barometer</keywords> 
<repo>https://github.com/zanderso/cordova-plugin-barometer</repo> 
<issue></issue> 


<js-module src="www/Pressure.js" name="Pressure"> 
<clobbers target="Pressure" /> 
</js-module> 


«js-module src="www/barometer.js" name="barometer"> 
<clobbers target-"navigator.barometer" /> 
</js-module> 


<1-- android --> 
<platform name="android"> 


<config-file target-"res/xml/config.xml" parent="/*"> 
<feature name="Barometer"> 
<param name-"android-package" value="org.dartlang.phonegap.barometer. BarometerListener’/> 
</feature> 
</config-file> 


<source-file src="src/android/BarometerListener java" target-dir="src/org/dartlang/phonegap/barometer" /> 


</platform> 
</plugin> 
(2) 编写 Cordova 插件 文件 
编写 Cordova 插件 文件 barometerjs 设置 可 以 访问 气压 计 的 数据 ， 有 具体 实现 代码 如 下 : 
var argscheck = require(‘cordova/argscheck’), 
utils = require("cordova/utils"), 
exec = require("cordova/exec"), 
Acceleration = require('./Pressure’); 


var running = false; 
var timers = {}; 


var listeners = []; 
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var pressure = null; 


/人 告知 本 地 开始 测试 获取 数据 
function start() { 
exec(function(a) { 
var tempListeners = listeners.slice(0); 
pressure = new Pressure(a.val, a.timestamp); 
for (var i = 0, | = tempListeners.length; i < I; i++) { 
tempListeners[i].win(pressure); 
) 
}, function(e) ( 
var tempListeners - listeners.slice(0); 
for (var i = 0,1 = tempListeners.length; i < l; i++) ( 
tempListeners[i].fail(e); 


} 
}, "Barometer", "start", []); 
running = true; 


) 


// 告 知 本 地 停止 获取 数据 

function stop() { 
exec(null, null, "Barometer", "stop", []); 
running 7 false; 


) 


/在 监听 数组 中 添加 回调 
function createCallbackPair(win, fail) { 
return {win:win, fail:fail}; 


} 


function removeListeners(I) { 
var idx = listeners.indexOf(I); 
if (idx > -1) { 
listeners.splice(idx, 1); 
if (listeners.length === 0) { 
stop(); 
} 


} 


var barometer = { 
p 
* 异步 获取 当前 的 气压 


* @param {Function} successCallback The function to call when the pressure data is available 

* @param {Function} errorCallback The function to call when there is an error getting the pressure 
data. (OPTIONAL) 

* @param {BarometerOptions} options The options for getting the barometer data such as frequency. 
(OPTIONAL) 
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getCurrentPressure: function(successCallback, errorCallback, options) { 
argscheck.checkArgs(fFO', 'barometer.getCurrentPressure', arguments); 


var p; 

var win = function(a) ( 
removeListeners(p); 
successCallback(a); 

E 

var fail = function(e) ( 
removeListeners(p); 
errorCallback && errorCallback(e); 


k: 
p = createCallbackPair(win, fail); 
listeners.push(p); 
if (Irunning) { 
start(); 
) 
) 
p 


“在 一 个 指定 的 事件 间隔 内 不 间断 地 异步 获取 气压 值 


* @param {Function} successCallback 
* @param {Function} errorCallback The function to call when there is an error getting the pressure 
data. (OPTIONAL) 
* @param {BarometerOptions} options The options for getting the barometer data such as frequency. 
(OPTIONAL) 
* @return String The watch id that must be passed to #clearWatch to stop 
watching. 
Hi 
watchPressure: function(successCallback, errorCallback, options) ( 
argscheck.checkArgs(fFO', 'barometer.watchPressure', arguments); 
var frequency = (options && options frequency && typeof options frequency == 'number') ? options. 
frequency : 10000; 


// 读 取 压 力 数值 
var id = utils.createUUID(); 


var p = createCallbackPair(function(){}, function(e) { 
removeListeners(p); 
errorCallback && errorCallback(e); 

D: 


listeners.push(p); 


timers[id] = { 
timer:window.setinterval(function() { 
if (pressure) { 
successCallback(pressure); 


} 
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}, frequency), 
listeners:p 


k 


if (running) ( 
if (pressure) ( 
successCallback(pressure); 
) 
) else ( 
start(); 
} 


гейт id; 


H 


p 
* 清 除 指定 的 气压 表 


* @param {String} id The id of the watch returned from #watchPressure. 
"| 


clearWatch: function(id) { 
if (id && timers[id]) { 
window.clearinterval(timers[id].timer); 
removeListeners(timers[id].listeners); 
delete timers[id]; 


} 
Y 
module.exports = barometer; 
(3) 定义 每 个 时 间 点 的 压力 值 
编写 文件 Pressure.js 定义 每 个 时 间 点 的 压力 值 ， 具 体 代 码 如 下 : 
var Pressure = function(val, timestamp) { 
this.val = val; 
this.timestamp = timestamp || (new Date()).getTime(); 
Y; 


module.exports = Pressure; 
CA). 监听 传感器 传 来 的 和 存储 的 新 压力 值 
在 Android 平台 下 编写 Java 程序 文件 BarometerListenerjava, 功能 是 监听 传感器 传 来 的 和 存储 的 新 
压力 值 ， 具 体 实现 代码 如 下 : 
pt 
* 监听 传感器 传 来 的 和 存储 的 新 压力 值 
M 
public class BarometerListener extends CordovaPlugin implements SensorEventListener { 
public static int STOPPED = 0; 
public static int STARTING = 1; 


public static int RUNNING = 2; 
public static int ERROR. FAILED TO START = 3; 
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private float pressure; /最 近 的 压力 值 

private long timestamp; /最 近 的 时 间 值 

private int status; /| 监听 级 别 

private int accuracy = SensorManager.SENSOR STATUS UNRELIABLE; 
private SensorManager sensorManager; //SensorManager 对 象 
private Sensor mSensor; /传递 气压 传感器 

private CallbackContext callbackContext; /跟踪 JS 回调 的 上 下 文 


private Handler mainHandler=null; 
private Runnable mainRunnable = new Runnable() { 
public void run() { 
BarometerListener.this.timeout(); 
} 
y 


p 
* 创建 一 个 气压 监听 
cl 
public BarometerListener() { 
this.pressure = 0; 
this.timestamp = 0; 
this.setStatus(BarometerListener.STOPPED); 
} 


p 
“初始 化 处 理 ， 得 到 和 活动 相关 的 路 径 


* @param cordova The context of the main Activity. 
* @param webView The associated CordovaWebView. 
5] 
@Override 
public void initialize(Cordovalnterface cordova, CordovaWebView webView) { 
super. initialize(cordova, webView); 
this.sensorManager = (SensorManager) cordova.getActivity().getSystemService(Context. SENSOR_ 


SERVICE); 

} 

p 
“执行 获取 请 求 
* 
* @param action The action to execute. 
* @param args The exec() arguments. 
* @param callbackld The callback id used when calling back into JavaScript. 
* @return Whether the action was valid. 
T 


public boolean execute(String action, JSONArray args, CallbackContext callbackContext) { 
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if (action.equals("start")) { 
this.callbackContext = callbackContext; 
if (this.status != BarometerListener.RUNNING) ( 
this.start(); 
) 
Jj 
else if (action.equals("stop")) ( 
if (this.status == BarometerListener.RUNNING) ( 
this.stop(); 
) 
) else ( 
return false; 


} 


PluginResult result = new PluginResult(PluginResult.Status.NO_RESULT, ""); 
result.setKeepCallback(true); 

callbackContext.sendPluginResult(result); 

return true; 


} 


p 
* 当 气压 传感器 被 关闭 时 则 停止 监听 
“if 

public void onDestroy() { 

this.stop(); 
} 


[fi зы a 
П 下 面 是 本 地 方法 

jl ——— 
Il 


p 
* 开 始 监听 传感器 
* @return status of listener 
“dl 
private int start() { 
// 如 果 已 经 开始 或 运行 则 返回 


if ((this.status == BarometerListener.RUNNING) || (this.status == BarometerListener.STARTING)) ( 
return this.status; 


} 


this.setStatus(BarometerListener. STARTING); 


/传感器 获取 和 气压 
List<Sensor> list = this.sensorManager.getSensorList(Sensor.TYPE PRESSURE); 


if (list 1= null) && (list.size() > 0)) ( 
this.mSensor = list.get(0); 
this.sensorManager.registerListener(this, this. Sensor, SensorManager.SENSOR DELAY Ul); 
this.setStatus(BarometerListener.STARTING); 


532 


взе REVERS, евеваючвев а FSI 


} else { 
this.setStatus(BarometerListener.ERROR FAILED TO START); 
this.fail(BarometerListener.ERROR FAILED TO START, "No sensors found to register barometer 
listening to."); 
return this.status; 


) 


/设置 一 个 超时 回调 的 主线 程 

stopTimeout(); 

mainHandler = new Handler(Looper.getMainLooper()); 
mainHandler.postDelayed(mainRunnable, 2000); 


return this.status; 


private void stopTimeout() { 
if(mainHandler!=null){ 
mainHandler.removeCallbacks(mainRunnable); 
} 
} 
p 
* 停 止 监听 
7 
private void stop() { 
stopTimeout(); 
if (this.status != BarometerListener.STOPPED) ( 
this.sensorManager.unregisterListener(this); 


} 
this.setStatus(BarometerListener.STOPPED); 
this.accuracy = SensorManager.SENSOR_STATUS_UNRELIABLE; 


} 


p 
“如 果 传 感 器 还 没有 开始 则 返回 一 个 错误 


* Called two seconds after starting the listener. 
* 
il 
private void timeout() ( 
if (this.status == BarometerListener. STARTING) { 
this.setStatus(BarometerListener.ERROR FAILED TO START); 
this.fail(BarometerListener.ERROR FAILED TO. START, "Barometer could not be started."); 


} 


p 
* Called when the accuracy of the sensor has changed. 
* (param sensor 
* (param accuracy 
sl 
public void onAccuracyChanged(Sensor sensor, int accuracy) ( 
if (sensor.getType() != Sensor. TYPE PRESSURE) ( 
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return; 
} 
if (this.status == BarometerListener. STOPPED) { 
return; 
} 
this.accuracy = accuracy; 
} 
p. 
* 传 感 器 监听 事件 


* @param SensorEvent event 
3 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() != Sensor.TYPE_PRESSURE){ 


return; 

} 

if (this.status == BarometerListener. STOPPED) ( 
return; 


} 
this.setStatus(BarometerListener.RUNNING); 
if (this.accuracy >= SensorManager.SENSOR_STATUS_ACCURACY_MEDIUM) { 


this.timestamp = System.currentTimeMillis(); 
this.pressure = event.values[0]; 


this.win(); 


} 


@Override 
public void onReset() { 
if (this.status == BarometerListener. RUNNING) { 
this.stop(); 
} 
} 


/发 送 一 个 错误 到 JS 文件 
private void fail(int code, String message) { 
JSONObject errorObj = new JSONObject(); 
try { 
errorObj.put("code", code); 
errorObj.put("message", message); 
} catch (JSONException e) ( 
e.printStackTrace(); 
} 
PluginResult err = new PluginResult(PluginResult.Status.ERROR, errorObj); 
err.setKeepCallback(true); 
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callbackContext.sendPluginResult(err); 
) 


private void win() ( 
PluginResult result - new PluginResult(PluginResult.Status.OK, this.getPressureJSON()); 
result.setKeepCallback(true); 
callbackContext.sendPluginResult(result); 


} 


private void setStatus(int status) { 
this.status = status; 
} 
private JSONObject getPressureJSON() { 
JSONObject г = new JSONObject(); 
try ( 
r.put("val", this.pressure); 
r.put("timestamp", this.timestamp); 
} catch (JSONException e) { 
e.printStackTrace(); 
} 
return г; 
i } 
至 此 ， 整 个 实例 介绍 完毕 ， 这 样 便 成 功 构建 了 一 个 简单 的 气压 计 模型 。 读 者 可 以 以 此 为 基础 进行 
拓展 ， 设 计 一 个 自己 喜欢 的 气压 计 程 序 。 


第 14 章 温度 传感器 和 湿度 传感器 


温度 传感器 (Temperature Transducer) 是 指 能 感受 温度 并 转换 成 可 用 输出 信号 的 传感器 。 和 测量 重 
量 、 温 度 一 样 ， 选 择 湿度 传感器 首先 要 确定 测量 范围 。 除 了 气象 、 科 研 部 门 外 ， 从 事 温 、 湿 度 测控 的 
一 般 不 需要 全 湿 程 (0-100%RH) 测量 。 在 当今 的 信息 时 代 ， 传 感 器 技术 与 计算 机 技术 、 自 动 控 制 技术 
紧密 结合 。 测 量 的 目的 在 于 控制 ， 测 量 范围 与 控制 范围 合 称 使 用 范围 。 当 然 ， 对 不 需要 从 事 测控 系统 
的 应 用 者 来 说 ， 直 接 选 择 通用 型 湿度 仪 即 可 。 本 章 将 详细 讲解 Android 设备 中 温度 传感器 和 湿度 传 感 
器 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


14.1 温度 传感器 详解 


CH 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 14 章 \ 温 度 传感器 详解 .avi 

从 17 世纪 初 人 们 开始 利用 温度 进行 测量 。 在 半导体 技术 的 支持 下 , 20 世纪 相继 开发 了 半导体 热电 
偶 传感器 、PN 结 温度 传感器 和 集成 温度 传感器 。 与 之 相应 ， 根 据 波 与 物质 的 相互 作用 规律 ， 相 继 开发 
了 声学 温度 传感器 、 红 外 传感器 和 微波 传感器 。 温 度 传感器 是 五 花 八 门 的 各 种 传感器 中 最 为 常用 的 一 
种 ， 现 代 的 温度 传感器 外 形 非常 小 ， 这 样 更 加 让 它 广泛 应 用 在 生产 实践 的 各 个 领域 中 ， 也 为 人 们 的 生 
活 提 供 了 无 数 的 便利 和 功能 。 


14.1.1 温度 传感器 介绍 


温度 传感器 有 4 种 主要 类 型 : 热电 偶 、 热 敏 电阻 、 电 阻 温度 检测 器 RTD) 和 IC 温度 传感器 。IC 
温度 传感器 又 包括 模拟 输出 和 数字 输出 两 种 类 型 。 在 现实 世界 中 ， 温 度 传感器 是 温度 测量 仪表 的 核心 
部 分 ， 品 种 繁多 。 按 测量 方式 可 以 分 为 接触 式 和 非 接触 式 两 大 类 ， 按 照 传感器 材料 及 电子 元 件 特性 分 
为 热电 阻 和 热电 偶 两 类 。 

在 当前 的 技术 水 平 条 件 下 ， 温 度 传感器 的 主要 原理 如 下 : 

(1) 金属 膨胀 原理 设计 的 传感器 

金属 在 环境 温度 变化 后 会 产生 一 个 相应 的 延伸 ， 因 此 传感器 可 以 以 不 同方 式 对 这 种 反应 进行 信号 
转换 。 

(2) 双人 金属 片 式 传感器 

双 金 属 片 由 两 片 不 同 膨胀 系数 的 金属 贴 在 一 起 而 组 成 ， 随 着 温度 变化 ， 材 料 A 比 另外 一 种 金属 膨 
胀 程度 要 高 ， 引 起 金属 片 弯曲 。 弯 曲 的 曲率 可 以 转换 成 一 个 输出 信号 

G) 双 金 属 秆 和 金属 管 传感器 

随 着 温度 的 升 高 ， 金 属 管 〈 材 料 AO 长 度 增加 ， 而 不 膨胀 钢 杆 《金属 BO 的 长 度 并 不 增加 ， 这 样 
由 于 位 置 的 改变 ， 金 属 管 的 线性 膨胀 就 可 以 进行 传递 。 反 过 来 ， 这 种 线性 膨胀 可 以 转换 成 一 个 输出 
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信号 。 
(4) 液体 和 气体 的 变形 曲线 设计 的 传感器 
在 温度 变化 时 ， 液 体 和 气体 同样 会 相应 产生 体积 的 变化 。 
综 上 所 述 ， 多 种 类 型 的 结构 可 以 把 这 种 膨胀 的 变化 转换 成 位 置 的 变化 ， 这 样 产 生 位 置 的 变化 可 以 
输出 为 电位 计 、 感 应 偏差 、 挡 流 板 等 形式 的 结果 。 


14.1.2 Android 系统 中 的 温度 传感器 


在 Android 系统 中 ， 早 期 版 本 的 温度 传感器 值 是 TYPE_TEMPERATURE， 在 新 版 本 中 被 TYPE 
AMBIENT TEMPERATURE BË, Android 温度 传感器 的 单位 是 C， 能 够 测量 并 返回 当前 的 温度 。 

在 Android 内 核 平 台中 自 带 了 大 量 的 传感器 源码 ， 读 者 可 以 在 Rexsee 的 开源 社区 http://www. 
rexsee.com/ 找 到 相关 的 原生 代码 。 其 中 使 用 温度 传感器 相关 的 原生 代码 如 下 : 


package rexsee.sensor; 


import rexsee.core.browser.Javascriptinterface; 
import rexsee.core.browser.RexseeBrowser; 
import android.content.Context; 

import android.hardware.Sensor; 

import android.hardware.SensorEvent; 

import android.hardware.SensorEventListener; 
import android.hardware.SensorManager; 


public class RexseeSensorTemperature implements Javascriptinterface { 


private static final String INTERFACE_NAME = "Temperature"; 

@Override 

public String getinterfaceName() { 
return mBrowser.application.resources. prefix + INTERFACE NAME; 

} 

@Override 

public Javascriptinterface getinheritInterface(RexseeBrowser childBrowser) { 
return this; 

} 

@Override 

public Javascriptinterface getNewinterface(RexseeBrowser childBrowser) { 
return new RexseeSensorTemperature(childBrowser); 


} 

public static final String EVENT ONTEMPERATURECHANGED = "onTemperatureChanged"; 
private final Context mContext; 

private final RexseeBrowser mBrowser; 

private final SensorManager mSensorManager; 

private final SensorEventListener mSensorListener; 

private final Sensor mSensor; 


private int mRate = SensorManager.SENSOR DELAY NORMAL; 
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private int mCycle = 100; //milliseconds 
private int mEventCycle = 100; //milliseconds 
private float mAccuracy = 0; 


private long lastUpdate = -1; 
private long lastEvent = -1; 


private float value = -999f; 


public RexseeSensorTemperature(RexseeBrowser browser) { 
mContext = browser.getContext(); 
mBrowser = browser; 
browser.eventList.add(EVENT ONTEMPERATURECHANGED); 


mSensorManager - (SensorManager) 
mContext.getSystemService(Context.SENSOR SERVICE); 


mSensor = mSensorManager.getDefaultSensor(Sensor.TYPE TEMPERATURE); 


mSensorListener = new SensorEventListener() ( 
@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) { 
} 
@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() != Sensor. TYPE TEMPERATURE) return; 
long curTime = System.currentTimeMillis(); 
if (lastUpdate == -1 || (curTime - lastUpdate) > mCycle) { 
lastUpdate = curTime; 
float lastValue = value; 
value = event.values[SensorManager.DATA_X]; 
if (lastEvent == -1 || (curTime - lastEvent) > mEventCycle) { 
if (Math.abs(value - lastValue) > mAccuracy) { 
lastEvent = curTime; 
mBrowser.eventList.run(EVENT_ 
ONTEMPERATURECHANGED); 


} 
public String getLastKnownValue() { 
return (value == -999) ? "null" : String.valueOf(value); 


) 


public void setRate(String rate) { 
mRate = SensorRate.getint(rate); 
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public String getRate() { 
return SensorRate.getString(mRate); 
} 
public void setCycle(int milliseconds) { 
mCycle = milliseconds; 


} 

public int getCycle() { 
return mCycle; 

} 


public void setEventCycle(int milliseconds) { 
mEventCycle = milliseconds; 


} 
public int getEventCycle() { 
return mEventCycle; 


public void setAccuracy(float value) { 
mAccuracy = Math.abs(value); 


} 
public float getAccuracy() { 
return mAccuracy; 


} 


public boolean isReady() { 
return (mSensor == null) ? false : true; 


} 
public void start() { 
if (isReady()) { 
mSensorManager.registerListener(mSensorListener, mSensor, mRate); 
) else { 
mBrowser.exception(getlnterfaceName(), "Temperature sensor is not found."); 


} 


} 
public void stop() { 
if (isReady()) { 
mSensorManager.unregisterListener(mSensorListener); 


} 


} 
14.1.3 ”实战 演练 一 一 开发 一 个 Android 温度 计 

本 实例 将 详细 讲解 在 Android 设备 中 实现 温度 计 功能 的 方法 。 

sa o Zoë DD 能 源码 路 径 


实例 14-1 开发 一 个 Android 温度 计 系 统 光盘 :daima\l4vwenduEX 


a) 实现 布局 文件 
编写 布局 文件 main.xml， 通 过 TextView 控件 显示 获取 的 温度 值 ， 具 体 实现 代码 如 下 : 
<LinearLayout xmins:android="http://schemas.android.com/apk/res/android" 
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android:orientation="vertical" 
android:layout_width="fill_parent" 
android:layout_height="fill_parent"><!- 添 加 一 个 垂直 的 线性 布局 --> 
<TextView 
android:id="@+id/title" 
android:gravity-"center horizontal" 
android:textSize="20px" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/title"/><!-- 添 加 一 个 TextView 控件 --> 
<TextView 
android:id="@+id/myTextView1" 
android:textSize="1 8px" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text="@string/myTextView1"/><!-- 添 加 一 个 TextView 控件 --> 
</LinearLayout> 
(2) 检测 温度 传感器 的 温度 变化 
为 该 项 目 添加 SensorSimulator 工具 的 ЈАК 包 ， 编 写 文件 activityjava 来 检测 温度 传感器 的 温度 变 
化 ， 并 设置 在 onSensorChanged() 方 法 中 只 对 SENSOR. TEMPERATURE 即 温度 变化 进行 检测 。 文 件 
activity.java 的 具体 实现 代码 如 下 : 
import org.openintents.sensorsimulator.hardware.SensorManagerSimulator; 


import wendu.R; 
import android.app.Activity; 
import android.hardware.SensorListener; 
import android.hardware.SensorManager; 
import android.os.Bundle; 
import android.widget.TextView; 
public class activity extends Activity { 
TextView myTextView1;// 当 前 温度 
11ЅепѕогМападег mySensorManager;//SensorManager 对 象 引 用 
SensorManagerSimulator mySensorManager;// 声 明 SensorManagerSimulator 对 象 ， 调 试 时 用 
@Override 
public void onCreate(Bundle savedinstanceState) (//3& € onCreate() 方 法 
super.onCreate(savedlInstanceState); 
setContentView(R.layout.main);// 设 置 当前 的 用 户 界面 
myTextView1 = (TextView) findViewByld(R.id.myTextView1);// 得 到 myTextView1 的 引用 
/imySensorManager = (SensorManager)getSystemService(SENSOR SERVICE); 


// 获 得 SensorManager 
/调试 时 用 
mySensorManager = SensorManagerSimulator.getSystemService(this, SENSOR_SERVICE); 
mySensorManager.connectSimulator(); 1155 Simulator 连接 
} 
private SensorListener mySensorListener = new SensorListener()( 
@Override 
public void onAccuracyChanged(int sensor, int accuracy) () //Æ5 onAccuracyChanged()75;& 
@Override 


public void onSensorChanged(int sensor, float[] values) { 11% onSensorChanged()75;& 
if(sensor == SensorManager.SENSOR_TEMPERATURE}// 只 检查 温度 的 变化 
e. 


sue exceanencas | 


myTextView1.setText(" 当 前 的 温度 为 : "+values[0]); // 将 当前 温度 显示 到 TextView 


} 
} 
k 
@Override 


protected void onResume() (//3& E onResume() 方 法 
mySensorManager.registerListener(// 注 册 监 听 
mySensorListener, // 监 听 器 SensorListener 对 象 
SensorManager.SENSOR_TEMPERATURE,// 传 感 器 的 类 型 为 温度 
SensorManager.SENSOR_DELAY_UI// 传 感 器 事件 传递 的 频 度 
y 
super.onResume(); 
} 
@Override 
protected void onPause() {// 重 写 onPause() 方 法 
mySensorManager.unregisterListener(mySensorListener);// 取 消 注册 监听 器 
super.onPause(); 
} 
} 
至 此 ， 整 个 实例 介绍 完毕 。 运 行 电脑 端 的 sensorsimulator 工具 ， 调 整 工具 中 的 参数 使 其 模拟 温度 
传感器 。 在 Environment Sensor 中 选择 Temperature， 在 Quick Setting 面板 中 对 温度 进行 快速 设置 ， 在 
传感器 模拟 器 中 会 显示 当前 所 有 的 模拟 参数 ， 运 行 后 会 显示 获取 的 温度 值 。 


14.1.4 ”实战 演练 一 一 测试 电池 的 温度 


本 实例 将 详细 讲解 测试 Android 设备 的 电源 温度 的 方法 。 本 实例 在 现实 中 可 能 不 会 有 市 场 效 益 ， 
但 是 演示 了 测试 电源 温度 的 方法 ， 对 初学 者 来 说 具有 指导 意义 。 


(1) 实现 布局 文件 
编写 布局 文件 main.xml， 功 能 是 通过 按钮 控件 来 控制 测 温 功能 ， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmins:mako = "http://schemas.android.com/apk/res/com.mako" 
android:orientation-"horizontal" 
android:layout, width-"match parent" 
android:layout height-"match parent" 
> 
<LinearLayout 
android:orientation-"vertical" 
android:layout height-"match parent" 
android:layout width-"62dp" 
android:gravity-"bottom|center horizontal" 
> 
<ZoomControls android:id = "@+id/zoomControl" 
android:rotation="90" 
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android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:orientation-" vertical" /> 
<com.mako.RecCheckButton android:id="@+id/recCheckButton" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" /> 
</LinearLayout> 
«com.mako.TemperatureDataView 
android:layout width-"match parent" 
android:layout height-"match parent" /> 
«I-- «com.mako.FrogListView 
android:layout width-"match parent" 
android:layout height-"match parent" /> --> 
</LinearLayout> 
(2) 监听 用 户 在 主屏 幕 的 操作 
编写 文件 mainactjava， 功 能 是 监听 用 户 在 主屏 幕 的 操作 ， 根 据 操 作 来 执行 对 应 的 响应 事件 处 理 函 
数 。 文 件 mainactjava 的 具体 实现 代码 如 下 : 
public class mainact extends Activity{ 
protected ArrayList<ArrayList<Datum>> temperaturesBaseRecordings; 
protected LinkedList<SummaryLayer> summaries; 
public void beginRecording()( 
) 


public void haltRecording()( 
} 


@Override 

public void onCreate(Bundle savedinstanceState){ 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.main); 


) 


@Override 

public void onRestorelnstanceState(Bundle state)( 
super.onRestorelnstanceState(state); 

} 

@Override 

public void onSavelnstanceState(Bundle state)( 
super.onSavelnstanceState(state); 

} 

@Override 

public void onResume(){ 
super.onResume(); 

} 

@Override 

public void onRestart(){ 
super.onRestart(); 

} 

@Override 
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public void onDestroy(){ 
super.onDestroy(); 
} 
} 
(3) 实现 基准 数据 处 理 
编写 文件 Datumjava 实现 基准 数据 处 理 ， 具 体 实现 代码 如 下 : 
public class Datum implements Parcelable { 
public float temperature; 
public static final int 
CONTAMINATED_BY_ENGAGEMENT=1, /*that is, if it's being used, Likely to draw more power and 
raise battery temp*/ 
CONTAMINATED BY CHARGING-2, 
CONTAMINATED BY EMPTIES-4, 
NO DATA - 5; 
public int flags; 
public Datum(float temp, int flag)(temperature = temp; flags = flag;} 


public int describeContents()(return 0;) 

public void writeToParcel(Parcel out, int flaggings)( 
out.writeInt(flags); 
out.writeFloat(temperature); 


} 
public static final Parcelable.Creator<Datum> CREATOR = new Parcelable.Creator<Datum>() { 
public Datum createFromParcel(Parcel in){ 
float tempor = in.readFloat(); 
int flagings = in.readint(); 
return new Datum(tempor, flagings); 


} 
public Datum [] newArray(int size)( 
return new Datum[size]; 
) 
k 
@Override 


public Datum clone(){ 
return new Datum(temperature, flags); 
} 
} 
(4) 绘制 基准 视图 界面 
编写 文件 DatumView.java， 功 能 是 调用 基准 数据 类 Datum 实现 绘制 基准 视图 界面 功能 ， 有 具体 实现 
代码 如 下 : 
class DatumView extends LinearLayout{ 
protected Datum у; 
protected TextView tv; 
protected Flaglmage fi; 
public static final float defaultHeightInches = (float)0.4; 
protected static BitmapDrawable[] flagBitmaps = new BitmapDrawable[8]; 
protected static BitmapDrawable nodatBitmap; 
public static Paint backGroundPaint; 
public static Paint haskPaint; 
public static Paint contaminatedEmpty; 
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public static Paint contaminatedUsage; 
public static Paint contaminatedCharging; 
public static Path laef; 
protected class Flagimage extends ImageView{ 
public Flaglmage(Context cont, AttributeSet айгѕ, int defStyle){ 
super(cont, attrs, defStyle); init(cont); } 
public Flaglmage(Context cont, AttributeSet attrs){ 
super(cont, attrs); init(cont); } 
public Flagimage(Context cont){ 
super(cont); init(cont); } 
protected int flags; 
protected void init(Context cont){ 
takeFlag(Datum.NO_DATA); 


} 

protected Bitmap paintBlank(int w, int h){ 
Bitmap surf = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB 8888); 
Canvas c = new Canvas(surf); 
c.drawPaint(backGroundPaint); 
float haskrad = (h*8)/10; 
float xo = w/2 - haskrad, yo = h/2 - haskrad; 
Path haskPath 7 new Path(); 
RectF arcRect = new RectF(xo,yo,xo + haskrad,yo + haskrad); 
float arcRad = 64; 
haskPath.addArc(arcRect, -45 - arcRad/2, arcRad); 
haskPath.addArc(arcRect, -(45+180) + arcRad/2, -arcRad); 
haskPath.close(); 
c.drawPath(haskPath, haskPaint); 
return surf; 


} 
protected Bitmap paintFlags(int w, int h, int flaggings){ 
Bitmap surf = Bitmap.createBitmap(w, h, Bitmap.Config.ARGB 8888); 
Canvas c = new Canvas(surf); 
c.drawPaint(backGroundPaint); 
float separation = 2; 
float oneFlagSpan = 
(w <= 5*separation)? 
0: 


(h < 2*separation + (w - 5*separation)/3)? 
h - 2*separation: 
(w - 5*separation)/3; 
float fullWidth = oneFlagSpan*3 + 5*separation; 
float fullHeight = oneFlagSpan + 2*separation; 
Path mlaef = new Path(laef); 
Matrix transf = new Matrix(); transf.setRectToRect( 
new RectF(0,0,1,1), 
new RectF((h - fullHeight)/2 + separation, (w - fullWidth)/2 + separation, 
separation*oneFlagSpan, separationtoneFlagSpan), 
Matrix.ScaleToFit.CENTER); 
mlaef.transform(transf); 
if((flaggings & Datum.CONTAMINATED_BY_ENGAGEMENT) != 0) c.drawPath(mlaef, 
contaminatedUsage); 
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mlaef.offset(oneFlagSpan + separation, 0); 
if((flaggings & Datum.CONTAMINATED BY CHARGING) != 0) c.drawPath(mlaef, 
contaminatedCharging); 
mlaef.offset(oneFlagSpan + separation, 0); 
if((flaggings & Datum.CONTAMINATED_BY_EMPTIES) != 0) c.drawPath(mlaef, 
contaminatedEmpty); 
return surf; 
} 
protected void installFlag(){ 
if(flags == 0) return; 
if((flags & Datum.NO DATA) != 0){ 
if(nodatBitmap != null) setlmageDrawable(nodatBitmap); 
else 
setlmageDrawable(( nodatBitmap = new BitmapDrawable( 
getContext().getResources(), 
paintBlank(getWidth(), getHeight())) )); 
Jelse( 
int Падіпаех = flags&(7); 
if(flagBitmaps[flagIndex] != null) setlmageDrawable(flagBitmaps[flagIndex]); 
else 
setlmageDrawable(( flagBitmaps[flaglndex] = new BitmapDrawable( 
getContext().getResources(), 
paintFlags(getWidth(), getHeight(), flags)) )); 


} 
} 
public void takeFlag(int inFlag)( 
flags = inFlag 
if(getHeight() != 0 && getWidth() = OX 
installFlag(); 
} 
} 
@Override 


public void onSizeChanged(int oldw, int oldh, int w, int h){ 
for(int i = 0; i < flagBitmaps.length; ++i) flagBitmaps[i] = null; 
nodatBitmap = null; 
takeFlag(flags); 

} 

} 
public DatumView(Context cont, AttributeSet attrs, int defStyle){ 
super(cont, attrs, defStyle); 

init(cont); 

} 
public DatumView(Context cont, AttributeSet attrs){ 
super(cont, attrs); 


init(cont); 

} 

public DatumView(Context cont){ 
super(cont); 
init(cont); 

} 


protected void init(Context cont)( 
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Log.v("frog", "DatumView created"); 

if(backGroundPaint == null){ 
backGroundPaint = new Paint(); 
backGroundPaint.setColor(Oxffo0b0b0); 

} 

if(haskPaint == null){ 

haskPaint = new Paint(Paint.ANTI ALIAS FLAG); 
haskPaint.setColor(OxffbObObO); 

} 

if(contaminatedCharging == null){ 

contaminatedCharging = new Paint(Paint.ANTI ALIAS FLAG); 
contaminatedCharging.setColor(Oxffffff00); 

} 

if(contaminatedUsage == null){ 

contaminatedUsage = new Paint(Paint.ANTI ALIAS FLAG); 
contaminatedUsage.setColor(OxffOOff00); 

} 

if(contaminatedEmpty == null){ 

contaminatedEmpty = new Paint(PainLANTI ALIAS FLAG); 
contaminatedEmpty.setColor(OxffOOffff); 

} 

if(laef == null){ 

float cornerDeg = (float)0.1; 
laef = new Path(); 
laef.moveTo(0,cornerDeg); 
laef.lineTo(cornerDeg,0); 
laef.lineTo(1,0); 
laef.lineTo(1,1 - cornerDeg); 
laef.lineTo(1 - cornerDeg,1); 
laef.lineTo(0,1); 

laef.close(); 

} 

fi = new Flaglmage(cont); 

fi.takeFlag(Datum.NO_DATA); 

tv = new TextView(cont); 

LinearLayout.LayoutParams tvLParams = new LinearLayout.LayoutParams(0, 
ViewGroup.LayoutParams.WRAP CONTENT); tvLParams.gravity = android.view.Gravity.LEFT;tvLParams. 
weight = 1; 

LinearLayout.LayoutParams fiLParams = new LinearLayout.LayoutParams(0, ViewGroup. LayoutParams. 
MATCH, PARENT, 0); tvLParams.gravity = android.view.Gravity.RIGHT; tvLParams.weight = 0; 

addView(tv, tvLParams ); 

addView(fi, fiLParams ); 


} 
protected void installDatum(Datum in){ 
vein; 
if(v == null || (v.flags & Datum.NO DATA) = O( 
Jelse( 
tv.setText(""+v.temperature); 
fi.takeFlag(v.flags); 
ђ 
} 
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(5) 记录 测试 的 数据 
编写 文件 recordingjava， 功 能 是 记录 测试 的 数据 ， 并 将 各 个 记录 的 值 保存 到 DB 数据 库 中 。 文 件 
recording.java 的 具体 实现 代码 如 下 : 
public class recording extends Service{ 
public static final long MEASURE INTERVAL IN MILLISECONDS = 1000* 60* 5; 
protected int currentTemperature; 
protected boolean isCharging; 
protected boolean isBeingUsed; 
protected ScheduledThreadPoolExecutor timer; 
protected ScheduledFuture<?> future; 
protected Runnable recordingTask = new Runnable(){ 
@Override public void run(){ 


} 

Б 

protected BroadcastReceiver batteryInfoReceiver = new BroadcastReceiver(){ 
@Override 


public void onReceive(Context context, Intent intent){ 
currentTemperature = intent.getIntExtra(BatteryManager.EXTRA TEMPERATURE,0); 
isCharging = ((intent.getIntExtra(BatteryManager.EXTRA STATUS,0) & BatteryManager. 
BATTERY STATUS CHARGING) != 0); 
Ж 
protected BroadcastReceiver ѕсгеепіѕОпКесіехег = new BroadcastReceiver(){ 
@Override 
public void onReceive(Context context, Intent intent isBeingUsed = true; }}; 
protected BroadcastReceiver screenlsOffReciever = new BroadcastReceiver(){ 
@Override 
public void onReceive(Context context, Intent intent — isBeingUsed = false; }}; 

@Override public int onStartCommand(Intent intent, int flags, int startld){ 
this.registerReceiver(batteryInfoReceiver, new IntentFilter(Intent ACTION_BATTERY_CHANGED)); 
this.registerReceiver(screenlsOnReciever, new IntentFilter(Intent ACTION_SCREEN_ON)); //using 

SCREEN_ON instead of USER_PRESENT as screen is likely to tax the battery even without active use. | 
suppose the variable this binds to is a misnomer 
this.registerReceiver(screenlsOffReciever, new IntentFilter(Intent ACTION_SCREEN_OFF)); 
timer = new ScheduledThreadPoolExecutor(1); 
return START_STICKY; 
} 
public void startRecording(){ 
/lopen db 
licreate db? 
/lint initialDelay = 
future = timer.scheduleAtFixedRate( 
recordingTask, 
0, 
MEASURE_INTERVAL_IN_MILLISECONDS, 
java.util.concurrent.TimeUnit. MILLISECONDS ); 

} 

public void haltRecording(){ 
future.cancel(false); 


} 
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} 


@Override 
public IBinder onBind(Intent intent){return null;} 


(6) 生成 图 形 化 温度 数据 视图 


编写 文件 TemperatureDataViewjava， 功 能 是 将 存储 记录 的 数字 生成 一 个 图 形 化 的 温度 数据 视图 。 
文件 TemperatureDataView.java 的 具体 实现 代码 如 下 : 
class TemperatureDataView extends ScrollView{ 


protected RelativeLayout layout; 

protected View upperView; 

protected static final int upperViewID-0; 

protected View lowerView; 

protected static final int lowerViewID-1; 

protected int upperChild=-1, lowerChild=-1; 

protected int highestID=2; 

protected int dbLength; 

protected boolean seesEnd; 

protected int[] viewsPageCycle; 

protected int viewsPageEye; 

protected int basalRecord; 

protected int pageSize; 

protected int nPages; 

protected boolean sizeGiven = false; 

protected ExecutorService pool; 

protected Future<ArrayList<Datum>> lowerAccess; 

protected Future<ArrayList<Datum>> upperAccess; 

public static final float defaultitemHeightInches = (float)0.4; 

protected int itemHeight; 

protected RelativeLayout.LayoutParams defltemParams()( 
return new RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH PARENT, 


itemHeight); 


) 


protected class AccessTask implements Callable<ArrayList<Datum>>{ 
int first, n; 
Datum defdat = new Datum(0, Datum.CONTAMINATED BY ENGAGEMENT | 


Datum.CONTAMINATED BY CHARGING | Datum.CONTAMINATED BY EMPTIESJ; 


public AccessTask(int firstID, int nitems){ //, DB db){ 
first = firstID; n = nltems; 


} 
public ArrayList<Datum> call(){ 
ArrayList<Datum> ret = new ArrayList<Datum>(n); 


for(Datum dat : ret) dat = defdat.clone(); 
return ret; 


} 


protected void increaseUpperPadsSize()( 
RelativeLayout.LayoutParams newUppersLayoutParams = new 


RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 


的 
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upperView.getHeight()*pageSize*itemHeight); 
newUppersLayoutParams.addRule(RelativeLayout.ALIGN PARENT TOP); 
layout.updateViewLayout(upperView, newUppersLayoutParams); 


protected void accessLower()( 
if(lowerAccess == null) 
lowerAccess = pool.submit(new AccessTask(basalRecord+nPages*pageSize, pageSize)); 
} 
protected void finalizeShiftViewDown(){ 
ArrayList<Datum> resultList; 
if(lowerAccess == null){ 
accessLower(); 
} 


try{ 

resultList = lowerAccess.get(); 
Jcatch(InterruptedException ex)(throw new RuntimeException("db access thread interrupted?");} 
catch(ExecutionException ex){throw new RuntimeException("db access thread interrupted?");} 


increaseUpperPadSize(); 
int viewsPageCyclelter = viewsPageEye*pageSize; 
int end = viewsPageCyclelter+pageSize; 
int previousLayoutlD = 
(viewsPageEye == 0)? 
viewsPageCycle[nPages*pageSize - 1]: 
viewsPageCycle[viewsPageEye*pageSize -1]; 
Iterator<Datum> iter = resultList.iterator(); 
while(viewsPageCyclelter != епа) 
layout.removeViewAt(viewsPageCycle[viewsPageCyclelter]); 
int newLayoutID = highestID++; 
viewsPageCycle[viewsPageCyclelter] = newLayoutlD; 
RelativeLayout.LayoutParams params = defltemParams(); 
params.addRule(RelativeLayout.BELOW, previousLayoutlD); 
DatumView dv = new DatumView(getContext()); 
dv.installDatum(iter.next()); 
layout.addView(dv, newLayoutlD, params); 
++viewsPageCyclelter; 
previousLayoutlD = newLayoutlD; 
} 
/*lidecrease the lower pad size and reattach it to previousLayoutID; //по. size only changes when 
dbLength changes 
RelativeLayout.LayoutParams params = new 
RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 
lowerView.getHeight()-pageSize*itemHeight); 
params.addRule(RelativeLayout.BELOW, previousLayoutID); 
layout.updateViewLayout(lowerView, params);*/ 
++viewsPageEye; if(viewsPageEye == nPages) viewsPageEye = 0; 
basalRecord+=pageSize; 
lowerAccess = null: 
} 
protected void acceptFirstSizing(){ 
pageSize = this.getHeight()/itemHeight; 
nPages = 3; 
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assert pageSize > 0 : "it looks like size isn't assigned before initialization :(. just make pagesize big or 
something"; 

viewsPageCycle = new int[nPages*pageSize]; 

for(int i = 0; i < viewsPageCycle.length ; ++i) viewsPageCycle[i] = -1; 

viewsPageEye = 0; 

layout = new RelativeLayout(getContext()); 

seesEnd = false; 

lowerView = new View(getContext()); 

upperView = new View(getContext()); 

RelativeLayout.LayoutParams params = new 
RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 0); 

params.addRule(RelativeLayout.ALIGN_PARENT_TOP); 

layout.addView(upperView, upperViewID, params); 

dbLength = 50; 

params = new RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 
dbLength*itemHeight); 

params.addRule(RelativeLayout.ALIGN PARENT ТОР); 

layout.addView(lowerView, lowerViewID, params); 

addView( 

layout, 
new ViewGroup.LayoutParams( 
ViewGroup.LayoutParams.MATCH PARENT, 
ViewGroup.LayoutParams. WRAP  CONTENT)); 

if(dbLength*itemHeight « getHeight()) seesEnd-true; 

relocate(0); 

ScrollTo(0,0); 


protected void init(Context cont)( 
pool = Executors.newFixedThreadPool(2); 
{ 


android.util.DisplayMetrics metrics = new android.util.DisplayMetrics(); 


((WindowManager)cont.getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay().getMetrics( 
metrics); 


itemHeight = (int)(defaultltemHeightInches * metrics.densityDpi); 
} 


} 

public TemperatureDataView(Context cont, AttributeSet attrs, int defStyle)( 
super(cont, attrs, defStyle); 
init(cont); 

} 

public TemperatureDataView(Context cont, AttributeSet attrs){ 
super(cont, attrs); 


init(cont); 

} 

public TemperatureDataView(Context cont){ 
super(cont); 
init(cont); 

} 


protected void addDatumBegin(Datum v){ 


DatumView view = new DatumView(getContext()); 
e 


view.installDatum(v); 
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RelativeLayout.LayoutParams params = defltemParams(); 
if(upperChild != -1) params.addRule(RelativeLayout.ABOVE, upperChild); 
else params.addRule(RelativeLayout.ALIGN PARENT TOP, upperChild); 
upperChild = highestID++; 
layout.addView(view, upperChild, params); 

} 

protected void addDatumEnd(Datum v){ 
DatumView view = new DatumView(getContext()); 
view.installDatum(v); 
RelativeLayout.LayoutParams params - defltemParams(); 
if(lowerChild != -1) params.addRule(RelativeLayout.BELOW, lowerChild); 
else params.addRule(RelativeLayout.ALIGN PARENT BOTTOM, lowerChild); 
lowerChild = highestID++; 
layout.addView(view, lowerChild, params); 


} 

public void notifyFreshDatum(){ 
++dbLength; 
if(seesEnd){ 
Jelse( 


RelativeLayout.LayoutParams params = new 

RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH PARENT, dbLength*itemHeight); 
params.addRule(RelativeLayout.ALIGN PARENT. BOTTOM); 
layout.updateViewLayout(lowerView, params); 


) 


@Override 
public void onSizeChanged(int oldw, int oldh, int w, int h)( 
if(IsizeGiven)( 
acceptFirstSizing(); 
sizeGiven-true; 


) 


protected void relocate(int у){ //initializes cached Datums for the new location 
if(y « 0) y-0; 
for(int i = 0; i « nPages*pageSize; ++i){ 
if(viewsPageCycle[i] != -1) layout.removeViewAt(viewsPageCycle[i]); 
} 
viewsPageEye = 0; 
basalRecord = (y/(itemHeight*pageSize) - itemHeight*(pageSize/2))*pageSize; 
highestID = 2; 
ArrayList<Datum> data = (new AccessTask(basalRecord, nPages*pageSize)).call(); 
int validStart = (basalRecord < 0)? -basalRecord : 0; 
RelativeLayout.LayoutParams upperLayoutParams; 
if(validStart == 0){ 
upperLayoutParams = new 
RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, basalRecord*itemHeight); 
Jelse( 
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upperLayoutParams = new 
RelativeLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 0); 
} 
upperLayoutParams.addRule(RelativeLayout.ALIGN_PARENT_TOP); 
layout.updateViewLayout(upperView, upperLayoutParams); 
int prevID = upperViewID; 
for(; validStart < data.size(); ++validStart){ 
Datum cur = data.get(validStart); 
DatumView curv = new DatumView(getContext()); 
if(cur != null) curv.installDatum(cur); 
int id = highestID++; 
RelativeLayout.LayoutParams params = defltemParams(); 
params.addRule(RelativeLayout.BELOW, previD); 
layout.addView(curv, id, params); 
viewsPageCycle[validStart] = id; 
previD = id; 
} 
upperChild = 2; 
lowerChild = previD; 
if(lowerAccess != null) lowerAccess.cancel(true); 
lowerAccess = null; 
if(upperAccess != null) upperAccess.cancel(true); 
upperAccess = null; 


} 


@Override 
public void scrollTo(int x, int y){ 
int loc = layout.getScrollY(); 
if(loc < у){ 
int height = getHeight(); 
if(y+height > (basalRecord+(int)(nPages*0.75)*pageSize)*itemHeight){ 
if(y*height > (basalRecord+nPages*pageSize)*itemHeight){ 
finalizeShiftViewDown(); 
}else{ 
accessLower(); 
} 
} 
} 


super.scrollTo(x,y); 


/Ipublic void selectDatabase() 
//public void pushFreshDatum(Datum іп) 
} 
至 此 , 整个 实例 介绍 完毕 , 在 模拟 器 中 的 执行 效果 如 图 14-1 所 示 , 在 真 机 中 会 显示 获取 的 温度 值 。 


sí 


图 14-1 执行 效果 
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人 类 的 生存 和 社会 活动 与 湿度 密切 相关 。 随 着 现代 化 的 实现 ， 很 难 找 出 一 个 与 湿度 无 关 的 领域 来 。 
由 于 应 用 领域 不 同 ， 对 湿度 传感器 的 技术 要 求 也 不 同 。 本 节 将 详细 讲解 使 用 Android 湿度 传感器 的 基 
本 知识 。 


14.2.1 Android 系统 中 的 湿度 传感器 


在 Android 系统 中 ， 湿 度 传感器 的 值 是 TYPE RELATIVE_HUMIDITY， 单 位 是 %， 能 够 测量 周围 环 
境 的 相对 湿度 。Android 系统 中 的 湿度 与 光线 、 气 压 、 温 度 传感器 的 使 用 方式 相同 ， 可 以 从 湿度 传感器 读 
取 到 相对 湿度 的 原始 数据 。 而 且 ， 如 果 设 备 同时 提供 了 湿度 传感器 (TYPE RELATIVE HUMIDITY) 和 
温度 传感器 (TYPE AMBIENT TEMPERATURE), 那么 就 可 以 用 这 两 个 数据 流 来 计算 出 结 露点 和 绝对 
湿度 。 
(1) 结 露 点 
结 露 点 是 在 固定 的 气压 下 ， 空 气 中 所 含 的 气态 水 达到 饱和 而 凝结 成 液态 水 所 需要 降 至 的 温度 。 以 
下 给 出 了 计算 结 露 点 温度 的 公式 : 
In(RH/100%) + т. (T,+t) 
t(GRH) =T, 一 一 一 一 一 一 一 一 一 一 一 一 
m - [In(RH/100%) + m. И(Т,+0)] 


:= 上 述 公 式 中 ， 各 个 参数 的 具体 说 明 如 下 : 
а= 结 露 点 温度 ， 单 位 是 摄氏 度 'C。 
t= 当前 温度 ， 单 位 是 摄氏 度 'C。 
RH = 当前 相对 湿度 ， 单 位 是 百分比 (%)。 
ш = 18.62. 
Ta = 243.12. 
(2) 绝对 湿度 
绝对 湿度 是 在 一 定 体积 的 干燥 空气 中 含有 的 水 藻 气 的 质量 。 绝 对 湿度 的 计量 单位 是 克 / 立 方 米 。 以 
下 给 出 了 计算 绝对 湿度 的 公式 : 


d (t.RH) = 218.7- 


ЫШЫ Ыт 


(RH/100%) - A -exp(m-t/(T,++)) 
273.15 +t 


在 上 述 公式 中 ， 各 个 参数 的 具体 说 明 如 下 : 
d,- 绝对 湿度 ， 单 位 是 克 / 立 方 米 。 

t= 当前 温度 ， 单 位 是 摄氏 度 'C 。 

RH = 当前 相对 湿度 ， 单 位 是 百分比 (%)。 
ш = 18.62. 
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Ta =243.12C. 
A=6.112hPa. 


14.2.2 ”实战 演练 一 一 获取 远程 湿度 传感器 的 数据 


本 实例 将 详细 讲解 使 用 湿度 传感器 的 方法 ， 功 能 是 在 Android 设备 中 获取 远程 湿度 传感器 的 数据 。 


= Bl x» 能 源码 路 径 
Е. l 获取 远程 湿度 传感器 的 数据 ——— 000 光盘 :daima\l4vsensorEX — : 
COD 编写 布局 文件 


编写 布局 文件 activity_thread_async_task_main.xml， 在 界面 中 分 别 设置 Start 和 Stop 两 个 按钮 ， 在 
下 方 使 用 ProgressBar 控件 显示 获取 的 湿度 值 。 文 件 activity thread async task main.xml 的 具体 实现 代 


码 如 下 : 


<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 


(m 


xmins:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 

android:layout height-"match parent" 
android:onClick-"updateUrl" 
android:paddingBottom-"(g)dimen/activity vertical margin" 
android:paddingLeft-"(gdimen/activity horizontal margin" 
android:paddingRight-"(dimen/activity horizontal margin" 
android:paddingTop-"(dimen/activity vertical margin" 
tools:context-" ThreadAsyncTaskMainActivity" > 


«TextView 
android:id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/textView1" 
android:textSize="20sp" /> 


<EditText 
android:id="@+id/editText" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:visibility="invisible" /> 


<TableRow 
android:id="@+id/tableRow" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:layout_below="@id/editText" > 


<Button 
android:id="@+id/startButton" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
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android:layout_weight="1" 
android:onClick="onClickStart" 
android:text="@string/startButton" /> 


<Button 
android:id="@+id/stopButton" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weightz"1" 
android:onClick-"onClickStop" 
android:text="@string/stopButton" /> 


<Button 
android:id="@+id/setButton" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout_weight="1" 
android:onClick="onClickSet" 
android:text="@string/setButton" 
android:visibility="invisible" /> 
</TableRow> 


<ProgressBar 
android:id="@+id/progressBar1" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout_alignLeft="@+id/tableRow" 
android:layout_alignRight="@+id/tableRow" 
android:layout_below="@+id/tableRow" 
android:layout_marginTop="40dp" /> 
</RelativeLayout> 
(2) 监听 用 户 触摸 单 击 屏幕 控件 事件 并 处 理 
+ Activity 的 实现 文件 是 ThreadAsyncTaskMainActivityjava, 功能 是 监听 用 户 触 摸 单 击 屏幕 控件 的 
事件 ， 执 行 对 应 的 处 理 方法 。 文 件 ThreadAsyncTaskMainActivity.java 的 具体 实现 代码 如 下 : 
public class ThreadAsyncTaskMainActivity extends Activity { 
private static final String URL_SENSOR = "http://Imi92.cnam.fr/ds2438/ds2438/"; 
private Button startButton, stopButton, setButton; 
private ProgressBar progressBar; 
private EditText editText; 
private TextView textView; 
private String url; 
private long top, bot, acquitionTime = 3000; // 3s en ms 
private WorkAsyncTask task; 
private HumiditySensorAbstract ds2438; 


@Override 

protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity_thread_async_task_main); 


Е Android 物 联网 开发 从 入 门 到 实战 


/监听 主屏 幕 的 控件 触摸 事件 

startButton = (Button) findViewByld(R.id.startButton); 
stopButton = (Button) findViewByld(R.id.stopButton); 
setButton = (Button) findViewByld(R.id.setButton); 

editText = (EditText) findViewByld(R.id.editText); 

progressBar = (ProgressBar) findViewByld(R.id.progressBar1); 
textView = (TextView) findViewByld(R.id.textView1); 
startButton.setEnabled(true); 

stopButton.setEnabled(false); 

url = ThreadAsyncTaskMainActivity.loadURL_SENSOR(this); 


} 


r 
* sk Start 按钮 后 调用 WorkAsyncTask()i IGRE 
к 
public void onClickStart(View у) { 
Toast.makeText(this, "Starting...", Toast.LENGTH_SHORT).show(); 
task = new WorkAsyncTask(); 
task.execute(); 


} 
” 
* 单 击 Stop 按钮 后 停止 读 取 湿度 工作 
© 
public void onClickStop(View v) { 
Toast.makeText(this, "Stopping...", Toast.LENGTH_SHORT).show(); 
task.cancel(true); 
stopButton.setEnabled(false); 
startButton.setEnabled(true); 
textView.setText("Acquisition... Appuyez sur start"); 


} 

public void onClickSet(View v) { 
url = editText.getText().toString(); 
setButton.setVisibility(View.INVISIBLE); 
startButton.setEnabled(true); 
textView.setVisibility(View. VISIBLE); 
editText.setVisibility(View.INVISIBLE); 
ThreadAsyncTaskMainActivity.saveURL_SENSOR(this, url); 

} 


r 
* 更 新 远程 URL 地 址 
sil 
public void updateUrl(View v) ( 
setButton.setVisibility(View. VISIBLE); 
textView.setVisibility(View.INVISIBLE); 
editText.setVisibility(View. VISIBLE); 
editText.setText(url); 
stopButton.setEnabled(false); 
startButton.setEnabled(false); 
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} 


r 
* 保存 远程 传感器 的 URL 
al 
private static void saveURL_SENSOR(Context context, String url) { 
SharedPreferences prefs = PreferenceManager 
.getDefaultSharedPreferences(context); 
Editor edit = prefs.edit(); 
edit.putString("url sensor", url); 
edit.commit(); 


) 


r 
* 载 入 远程 传感器 的 URL 
ll 
private static String load/URL_SENSOR(Context context) { 
SharedPreferences prefs = PreferenceManager 
.getDefaultSharedPreferences(context); 
return prefs.getString("url sensor", URL. SENSOR); 
} 


private class WorkAsyncTask extends AsyncTask<Void, Float, Void> { 


@Override 
protected Void dolnBackground(Void... params) { 
while (lisCancelled()) ( 


try ( 
ds2438 = new HTTPHumiditySensor(url); 
top = System.currentTimeMillis(); 
float taux = ds2438.value(); 
bot = System.currentTimeMillis(); 
long time = top - bot; 
publishProgress(taux); 
SystemClock.sleep(acquitionTime - time); 


} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
return null; 
} 
@Override 


protected void onProgressUpdate(Float... values) { 
Time currentTime = new Time(); 
currentTime.setToNow(); 
String date = currentTime.format("%d.%m.%Y %H:%M:%S"); 
II String date = currentTime.format("%H:%M:%S"); 
textView.setText("[" + date + "] 452438 : " + values[0]); 
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progressBar.setProgress(values[0].intValue()); 


) 


@Override 

protected void onPreExecute() { 
startButton.setEnabled(false); 
stopButton.setEnabled(true); 

} 


@Override 
protected void onCancelled() { 
progressBar.setProgress(0); 


} 
} 


(3) 设置 远程 湿度 传感器 的 初始 URL 地 址 
编写 文件 HITPHumiditySensorjava， 功 能 是 设置 远程 湿度 传感器 的 初始 URL 地 址 , 具体 实现 代码 
如 下 : 
public class HTTPHumiditySensor extends HumiditySensorAbstract { 
II public final static String DEFAULT HTTP SENSOR = "http://localhost:8999/ds2438/"; 
public final static Sting DEFAULT HTTP SENSOR = "http://10.0.2.2:8999/ds2438/", 
public static final long ONE MINUTE = 60L * 1000L; 


private static String urlSensor; 


private HTTPHumiditySensor() ( 
this(DEFAULT HTTP. SENSOR); 
} 


public HTTPHumiditySensor(String urlSensor) { 
this.urlSensor = urlSensor; 


public float value() throws Exception { 
StringTokenizer st = new StringTokenizer(request(), "="); 
st.nextToken(); 
float f = Float.parseFloat(st.nextToken()) * 10F; 
return ((int) f) / 10F; 
} 


public long minimalPeriod() { 
if (urlSensor.startsWith("http://localhost") 
|| urlSensor.startsWith("http://10.0.2.2")) 
return 200L; 
else 
return 2000L; 
) 


public String getUrl() ( 


return HTTPHumiditySensor.urlSensor; 
e. 
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} 


private String request() throws Exception { 
URL url = new URL(urlSensor); 
URLConnection connection = url.openConnection(); 
BufferedReader in = new BufferedReader(new InputStreamReader( 
connection.getInputStream()), 128); 
String result = new String(""); 
String inputLine = in.readLine(); 
while (inputLine != null) { 
result = result + inputLine; 
inputLine = in.readLine(); 


in.close(); 
return result; 
[jid] 


) 
至 此 ， 整 个 实例 介绍 完毕 ， 在 真 机 中 执行 后 会 获取 并 显示 远程 湿度 传感器 的 湿度 。 
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第 15 章 条形码 解析 技术 详解 


在 当前 手机 系统 中 ， 无 论 是 智能 手机 还 是 普通 的 手机 ， 基 本 上 都 支持 手机 拍照 和 录制 视频 功能 ， 
这 些 功 能 都 是 通过 手机 上 的 摄像 头 实现 的 。 在 Android 系统 中 ， 上 述 照相 机 功能 是 通过 Camera 系统 实 
现 的。 另外 ， 通 过 摄像 头 可 以 实现 条 形 码 解析 技术 。 条 形 码 应 用 是 物 联网 设备 中 的 常见 应 用 之 一 ， 为 
人 们 的 生活 提供 了 极 大 的 便利 。 本 章 将 详细 讲解 在 Android 设备 中 使 用 摄像 头 解 析 条 形 码 的 方法 ， 为 
读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


15.1 Android 拍照 系统 结构 基础 
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在 Android RiP, Camera 〈 照 相机 /拍照 ) 系统 提供 了 取景 器 、 视 频 录 制 和 拍摄 相片 等 功能 ， 并 
且 还 具有 各 种 控制 类 的 接口 。 另 外 ， 在 Camera 系统 中 还 提供 了 Java 层 的 接口 和 本 地 接口 。 其 中 Java 
框架 中 的 Camera 类 实现 了 Java 层 相机 接口 ， 为 照相 机 类 和 扫描 类 使 用 。 而 Camera 的 本 地 接口 可 以 给 
本 地 程序 调用 ， 作 为 视频 输入 环节 应 用 于 摄像 机 和 视频 电话 领域 。 

Android 照相 机 系统 的 基本 层次 结构 如 图 15-1 所 示 。 


照相 机 应 用 和 扫描 类 应 用 平台 API 
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Camera 的 Java 类 


本 地 框架 


Android 系 统 


本 地 框架 kc ameraJNI、ui-Camera 库 、 
CameraService 和 硬件 抽象 层 
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信号 处 理 和 摄像 头 传感器 等 设备 硬件 和 驱动 


15-1 照相 机 系统 的 层次 结构 


Android 系统 中 的 Camera 系统 包括 Camera 驱动 程序 层 `.Camera 硬件 抽象 层 、AudioService、Camera 
本 地 库 、Camera 的 Java 框架 类 和 Java 应 用 层 对 Camera 系统 的 调用 。Camera 系统 的 具体 结构 如 图 15-2 
所 示 。 
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15-2 Camera 的 系统 结构 


在 图 15-2 所 示 的 结构 中 ， 各 个 构成 层次 的 具体 说 明 如 下 所 示 。 

(1) Camera 系统 的 Java 层 ， 代 码 路 径 是 frameworks/base/core/java/android/hardware/ s 

其 中 Camera java 是 主要 实现 的 文件 ， 对 应 的 Java 层次 的 类 是 android.hardware.Camera， 这 个 类 和 
INI 中 定义 的 类 是 一 个 ， 有 些 方法 通过 JNI 的 方式 调用 本 地 代码 得 到 ， 有 些 方法 自己 实现 。 

(2) Camera 系统 的 Java 本 地 调用 部 分 (JNI)， 代 码 路 径 是 frameworks/base/core/jni/android_ 
hardware_Camera.cpp。 

这 部 分 内 容 编译 成 为 目标 文件 libandroid runtime.so， 主 要 的 头 文件 在 目录 frameworks/base/ 
includemi/ 中 。 

(3) Camera 本 地 框架 ， 其 中 头 文件 路 径 是 frameworks/native/include/ui 或 frameworks/av/include/ 
camera/. 

源 代码 路 径 是 frameworks/native/libs/ui 或 frameworks/av/camera/ > 

这 部 分 的 内 容 被 编译 成 库 libui.so 或 libcamera_client.so。 

(4) Camera 服务 部 分 ， 代 码 路 径 是 frameworks/av/services/camera/libcameraservice/。 

这 部 分 内 容 被 编译 成 库 libcameraservice.so。 

为 了 实现 一 个 具体 功能 的 Camera 驱动 程序 , 在 最 底层 还 需要 一 个 硬件 相关 的 Camer 库 (例如 通过 
调用 video for linux 驱动 程序 和 Jpeg 编码 程序 实现 )。 这 个 库 将 被 Camera 的 服务 库 libcameraservice.so 
调用 。 

(5) 摄像 头 驱动 程序 。 
此 部 分 是 基于 Linux 的 Video for Linux 视频 驱动 框架 。 
(6) 硬件 抽象 层 。 

硬件 抽象 层 中 的 接口 代码 路 径 是 frameworks/base/include/ui/2X frameworks/av/include/camera/. 

其 中 的 核心 文件 是 CameraHardwarelnterface.h. 

在 Camera 系统 的 各 个 库 中 ， 库 libui.so 位 于 核心 的 位 置 ， 它 对 上 层 提供 的 接口 主要 是 Camera Ж, 
Ж libandroid_runtime.so 通过 调用 Camera 类 提供 对 Java 的 接口 , 并 且 实 现 了 android.hardware.camera 类 。 


© 


БЕ 


Ж libcameraservice.so 是 Camera 的 服务 器 程序 ， 它 通过 继承 libui.so 的 类 实现 服务 器 的 功能 ， 并 且 
与 libui.so 中 的 另外 一 部 分 内 容 通过 进程 间 通 信 〈 即 Binder 机 制 ) 的 方式 进行 通信 。 
库 libandroid runtime.so 和 libui.so 是 公用 库 ， 在 里 面 除 了 Camera 外 还 有 其 他 方面 的 功能 。 
Camera 部 分 的 头 文件 被 保存 在 frameworks/base/include/ui/ 目 录 中 ， 此 目录 是 和 库 libmedia.so 的 源 
文件 目录 frameworks/base/libs/mi/ 相 对 应 的 。 
在 Camera 中 主要 包含 如 下 头 文件 : 
ICameraClient.h 
Camera.h 
ICamera.h 
ICameraService.h 
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CameraHardwarelnterface.h 

文件 Camera.h 提供 了 对 上 层 的 接口 ， 而 其 他 的 几 个 头 文件 都 是 提供 一 些 接口 类 〈 即 包含 了 纯 虚 函 
数 的 类 )， 这 些 接口 类 必须 被 实现 类 继承 才能 够 使 用 。 

当 整 个 Camera 在 运行 时 , 可 以 大 致 上 分 成 Client 和 Server 两 个 部 分 , 它们 分 别 在 两 个 进程 中 运行 ， 
它们 之 间 使 用 Binder 机 制 实现 进程 间 通 信 。 这 样 在 客户 端 调用 接口 ， 功 能 则 在 服务 器 中 实现 ， 但 是 在 
客户 端 中 调用 就 好 像 直 接 调 用 服务 器 中 的 功能 ， 进 程 间 通 信 的 部 分 对 上 层 程序 不 可 见 。 

从 框架 结构 上 来 看 ,文件 ICameraService.h. ICameraClient.h 和 ICamera.h 中 的 3 个 类 定义 了 Camera 
的 接口 和 架构 ，ICameraService.cpp 和 Camera.cpp 两 个 文件 用 于 实现 Camera 架构 ，Camera 的 具体 功能 
在 下 层 调 用 硬件 相关 的 接口 来 实现 。 
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在 Linux 系统 中 ，Camera 驱动 程序 使 用 了 Linux 标准 的 Video for Linux 2 (V4L2) 驱动 程序 。 无 
论 是 内 核 空间 还 是 用 户 空 间 ， 都 使 用 VAL2 驱动 程序 框架 来 定义 数据 类 和 控制 类 。 所 以 在 移植 Android 
中 的 Camera 系统 时 , 也 是 用 标准 的 V4L2 驱动 程序 作为 Camera 的 驱动 程序 。 在 Camera 系统 中 , V4L2 
驱动 程序 的 任务 是 获得 Video 数据 。 


15.2.1 V4L2 API 


V4L2 是 VAL 的 升级 版 本 ， 是 Linux 下 视频 设备 程序 提供 的 一 套 接口 规范 。 包 括 一 套数 据 结构 和 
底层 V4L2 驱动 接口 。V4L2 驱动 程序 向 用 户 空间 提供 字符 设备 ， 主 设备 号 是 81。 对 于 视频 设备 来 说 ， 
次 设备 号 是 0 一 63。 次 设备 号 在 64—127 之 间 的 是 Radio 设备 ,次 设备 号 在 192—223 之 间 的 是 Teletext 
设备 ， 次 设备 号 在 215~255 之 间 的 是 УВІ 设备 。 

VAL2 中 常用 的 结构 体 在 内 核 文件 include/linux/videodev2.h 中 定义 ， 代 码 如 下 : 


struct v4I2 requestbuffers /申请 帧 缓冲 ， 对 应 命令 VIDIOC REQBUFS 
struct v4I2 capability // 视 频 设 备 的 功能 ， 对 应 命令 VIDIOC QUERYCAP 
struct v4I2_input // 视 频 输入 信息 ， 对 应 命令 VIDIOC_ENUMINPUT 
struct v4I2_standard /视频 的 制式 ， 如 PAL 和 NTSC， 对 应 命令 VIDIOC ENUMSTD 


@ 
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struct v4I2_format // 帧 的 格式 ， 对 应 命令 VIDIOC_G_FMT、VIDIOC_S_FMT 等 

struct v4I2_buffer /驱动 中 的 一 帧 图 像 缓 存 ， 对 应 命令 VIDIOC_QUERYBUF 

struct v4I2_crop // 视 频 信 号 矩形 边框 

v4I2_std_ id /视频 制式 
常用 的 ioctl 接口 命令 也 在 文件 include/linux/videodev2.h 中 定义 ， 代 码 如 下 : 
VIDIOC_REQBUFS /分 配 内 存 

VIDIOC_QUERYBUF /把 VIDIOC_REQBUFS 中 分 配 的 数据 缓存 转换 成 物理 地 址 

VIDIOC_QUERYCAP /查询 驱动 功能 

VIDIOC_ENUM_FMT // 获 取 当前 驱动 支持 的 视频 格式 

VIDIOC_S_FMT /设置 当前 驱动 的 视频 捕获 格式 

VIDIOC_G_FMT // 读 取 当 前 驱动 的 视频 捕获 格式 

VIDIOC_TRY_FMT /验证 当前 驱动 的 显示 格式 

VIDIOC_CROPCAP /查询 驱动 的 修剪 能 力 

VIDIOC_S_CROP /设置 视频 信号 的 矩形 边框 

VIDIOC_G_CROP // 读 取 视 频 信号 的 矩形 边框 

VIDIOC_QBUF // 把 数据 从 缓存 中 读 取出 来 

VIDIOC_DQBUF // 把 数据 放 回 缓存 队列 

VIDIOC_STREAMON /开始 视频 显示 函数 

VIDIOC_STREAMOFF /| 结束 视频 显示 函数 

VIDIOC_QUERYSTD // 检 查 当前 视频 设备 支持 的 标准 ， 例 如 PAL ak NTSC 


15.22 ”操作 V4L2 的 流程 


VAL2 中 提供 了 很 多 访问 接口 ， 可 以 根据 具体 需要 选择 操作 方法 。 不 过 需要 注意 的 是 ， 很 少 有 驱动 
完全 实现 了 所 有 的 接口 功能 。 所 以 在 使 用 时 需要 参考 驱动 源码 ， 或 仔细 阅读 驱动 提供 者 的 使 用 说 明 。 
VAL2 的 操作 流程 如 下 : 

(1) 打开 设备 文件 ， 具 体 代码 如 下 : 

int fd = open(Devicename,mode); 

Devicename: /dev/videoO, /dev/video1 …… 

Mode: O_RDWR [| О NONBLOCK] 

如 果 需 要 使 用 非 阻塞 模式 调用 视频 设备 ， 当 没有 可 用 的 视频 数据 时 不 会 阻塞 ， 而 会 立刻 返回 。 

(2) 获取 设备 的 capability， 具 体 代码 如 下 : 

struct v4l2 capability capability ; 

int ret = ioctl(fd, VIDIOC_QUERYCAP, &capability); 

在 此 需要 查看 设备 具有 什么 功能 ， 如 是 否 具有 视频 输入 特性 。 

(3) 选择 视频 输入 ， 代 码 如 下 : 

struct у412_їприїїприї; 

[єє 开始 初始 化 input 

int ret = ioctl(fd, VIDIOC_QUERYCAP, &input); 

每 一 个 视频 设备 可 以 有 多 个 视频 和 输入， 如果 只 有 一 路 输入 ， 则 可 以 没有 这 个 功能 

(4) 检测 视频 支持 的 制式 ， 具 体 代 码 如 下 : 
v4I2 std id std; 
do í 
ret = ioctl(fd, VIDIOC_QUERYSTD, &std); 
} while (ret == -1 && errno == EAGAIN); 
switch (std) { 
case V4L2_STD_NTSC: 
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(5) 设置 视频 捕获 格式 ， 具 体 代 码 如 下 : 
struct v4I2 format fmt; 
fmttype = V4L2 ВОЕ TYPE. VIDEO. OUTPUT; 
fmt.fmt.pix.pixelformat = VAL2 PIX FMT UYVY; 
fmt.fmt.pix.height = height; 
fmt.fmt.pix.width = width; 
fmt.fmt.pix.field = V4L2_FIELD_INTERLACED; 
ret = ioctl(fd, VIDIOC S РМТ, &fmt); 


if(ret) ( 
perror("VIDIOC S FMTn"); 
close(fd); 
return -1; 

) 


(6) 向 驱动 申请 帧 缓存 ， 有 具体 代码 如 下 : 
struct v4l2 requestbuffers req; 
if (ioctl(fd, VIDIOC REQBUFS, &req) == -1) ( 
return -1; 
) 
在 结构 у412 requestbuffers 中 定义 了 缓存 的 数量 ， 驱 动 会 根据 这 个 申请 对 应 数量 的 视频 缓存 。 通 过 


多 个 缓存 可 以 建立 FIFO， 这 样 可 以 提高 视频 采集 的 效率 。 


CD 获取 每 个 缓存 的 信息 ， 并 MMAP 映射》 到 用 户 空间 。 具 体 代码 如 下 : 
typedef struct VideoBuffer { 
void *start; 
size_t length; 
} VideoBuffer; 
VideoBuffer* buffers = calloc( req.count, sizeof(*buffers) ); 
struct v4I2 buffer buf; 
for (numBufs = 0; numBufs < req.count; numBufs++) ( /映射 所 有 的 缓存 
memset( &buf, 0, sizeof(buf) ); 
buf.type = VAL2 BUF TYPE VIDEO CAPTURE; 
buf.memory = VAL2 MEMORY MMAP; 
buf.index = numBufs; 


if (ioctl(fd, VIDIOC_QUERYBUF, &buf) == -1) ( /获取 到 对 应 index 的 缓存 信息 , 此 处 主要 利 
用 length 信息 及 offset 信息 来 完成 后 面 的 mmap 操作 
return -1; 
} 
buffers[numBufs].length = buf.length; 
/| 转换 成 相对 地 址 


buffers[numBufs].start = mmap(NULL, buf.length, 
PROT_READ | PROT_WRITE, 
MAP_SHARED, 
fd, buf.m.offset); 
if (buffers[numBufs].start == MAP FAILED) { 
return -1; 


} 


e. 
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(8) 开始 采集 视频 ， 具 体 代码 如 下 : 
int buf type= V4L2_BUF_TYPE_VIDEO_CAPTURE; 
int ret = ioctl(fd, VIDIOC_STREAMON, &buf_type); 
(9) 取出 FIFO 缓存 中 已 经 采样 的 帧 缓存 ， 具 体 代码 如 下 : 
struct v4I2 buffer buf; 
memset(&buf,0,sizeof(buf)); 
buftype-V4L2 BUF TYPE VIDEO CAPTURE; 
buf.memory-V4L2 MEMORY MMAP; 
buf.index=0;// 此 值 由 下 面 的 ioctl 返回 
if (ioctl(fd, VIDIOC_DQBUF, &buf) == -1) 
i 


return -1; 


} 
通过 上 述 代 码 ， 可 以 根据 返回 的 bufindex 找到 对 应 的 mmap 映射 好 的 缓存 ， 实 现 取 出 视频 数据 的 
功能 。 
(10) 将 刚刚 处 理 完 的 缓冲 重新 入 队列 尾 ， 这 样 可 以 循环 采集 ， 有 具体 代码 如 下 : 
if (ioctl(fd, VIDIOC_QBUF, &buf) == -1) ( 
return -1; 
} 


(11) 停止 视频 的 采集 ， 具 体 代 码 如 下 : 
int ret = ioctl(fd, VIDIOC_STREAMOFF, &buf type); 
(12) 关闭 视频 设备 ， 具 体 代码 如 下 : 
close(fd); 


152.3 V4L2 驱动 框架 


在 上 述 使 用 V4L2 的 流程 中 ,各 个 操作 都 需要 有 底层 V4L2 驱动 的 支持 。 在 内 核 中 有 一 些 非常 完善 
的 例子 。 例 如 在 Linux-2.6.26 内 核 目 录 /drivers/media/video//zc301/ 中 ， 文 件 zc301_core.c 实现 了 ZC301 
视频 驱动 代码 。 
(1) V4L2 驱动 注册 、 注 销 函数 
在 Video 核心 层 文件 drivers/media/video/videodev.c 中 提供 了 注册 函数 ， 具 体 代码 如 下 : 
int video_register_device(struct video_device *vfd, int type, int nr) 
参数 说 明 如 下 。 
video device: 要 构建 的 核心 数据 结构 。 
type: 表示 设备 类 型 ， 此 设备 号 的 基地 址 受 此 变量 的 影响 。 
ш: 如 果 end-base>nr>0， 次 设备 号 =base (基准 值 ， 受 туре 影响 ) +nr; 否则 系统 将 自动 分 配 
合适 的 次 设备 号 。 
我 们 具体 需要 的 驱动 只 需 构 建 video_device 结构 ,然后 调用 注册 函数 即 可 。 例 如 在 文件 zc301_core.c 
中 的 实现 代码 如 下 : 
err = video_register_device(cam->v4ldev, VFL TYPE GRABBER, video nr[dev nr]); 
在 Video 核心 层 文件 drivers/media/video/videodev.c 中 提供 了 如 下 注销 函数 : 
void video_unregister_device(struct video device *vfd) 
(2) К struct video device 
在 结构 video device 中 包含 了 视频 设备 的 属性 和 操作 方法 ,具体 可 以 参考 文件 zc301_core.c， 代 码 
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如 下 : 
strcpy(cam->v4Idev->name, "ZC0301[P] PC Camera"); 
cam->v4ldev->owner = THIS MODULE; 
cam->v4ldev->type = VID TYPE CAPTURE | VID TYPE. SCALES; 
cam->v4ldev->fops = &zc0301 fops; 
cam->v4ldev->minor = video nr[dev nr]; 
cam->v4ldev->release = video device release; 
video set drvdata(cam-»v4ldev, cam); 


在 上 述 zc301 的 驱动 中 并 没有 全 部 实现 struct video device 中 的 操作 函数 ， 例 如 vidioc querycap. 
vidioc g fmt сар, 这 是 因为 在 struct file operations zc0301 fops 中 的 zc0301 ioctl 实现 了 前 面 的 所 有 ioctl 
操作 ， 所 以 无 须 在 struct video device 中 再 次 实现 struct video device 中 的 操作 。 

另外 也 可 以 使 用 下 面 的 代码 来 构建 struct video device. 


static struct video_device camif_dev = 

{ 
.name = "s3c2440 camif", 
type = VID TYPE CAPTUREI|VID TYPE. SCALES|VID TYPE SUBCAPTURE, 
-fops = &camif fops, 
.minor = -1, 
release = camif dev release, 
.Vidioc querycap = vidioc querycap, 
.Vidioc enum fmt сар = vidioc enum fmt cap, 
-idioc g fmt cap = vidioc g fmt cap, 
.Vidioc s fmt cap = vidioc s fmt cap, 
.Vidioc queryctrl = vidioc queryctrl, 
.Vidioc g сіп = vidioc g сіті, 
.Vidioc s сіп = vidioc s сіп, 

k 

static struct file operations camif fops = 

{ 
.owner = THIS MODULE, 
.open = camif open, 
release = camif release, 
.read = саті read, 
.poll = camif poll, 
ioctl = video ioctl2, /* V4L2 ioctl handler */ 
ттар = саті ттар, 
Лѕеек = no_llseek, 

k 

结构 video ioctl2 是 在 文件 videodev.c 中 实现 的 ，video ioctl2 中 会 根据 ioctl 不 同 的 сша 来 调 
video device 中 的 操作 方法 。 


15.24 ”实现 Video 核心 层 
具体 实现 代码 请 参考 内 核 文 件 /drivers/media/videodev.c， 实 现 流程 如 下 所 示 。 
(1) 注册 256 个 视频 设备 ， 代 码 如 下 : 


static int init videodev_init(void) 
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int геї; 

if (register_chrdev(VIDEO_MAJOR, VIDEO_NAME, &video_fops)) { 
return -ElO; 

} 

геї = class register(&video class); 


在 上 述 代码 中 注册 了 256 个 视频 设备 和 video class 类 , video fops 为 这 256 个 设备 共同 的 操作 方法 。 
(2) 实现 V4L2 驱动 的 注册 函数 ， 具 体 代 码 如 下 : 
int video register device(struct video device *vfd, int type, int пг) 
{ 
int і=0; 
int base; 
int end; 
int ret; 
char *name_base; 
switch(type) /根据 不 同 的 type 确定 设备 名 称 、 次 设备 号 
{ 
case VFL_TYPE_GRABBER: 
base=MINOR_VFL_TYPE_GRABBER_MIN; 
end=MINOR_VFL_TYPE_GRABBER_MAX+1; 
name_base = "video"; 
break; 
case VFL_TYPE_VTX: 
base=MINOR_VFL_TYPE_VTX_MIN; 
end=MINOR_VFL_TYPE_VTX_MAX+1; 
name_base = "vtx"; 
break; 
case VFL_TYPE_VBI: 
base=MINOR_VFL_TYPE_VBI_MIN; 
end=MINOR_VFL_TYPE_VBI_MAX+1; 
name_base = "vbi"; 
break; 
case VFL_TYPE_RADIO: 
base=MINOR_VFL_TYPE_RADIO_MIN; 
end=MINOR_VFL_TYPE_RADIO_MAX+1; 
name_base = "radio"; 
break; 
default: 
printk(KERN_ERR "%s called with unknown type: %d\n", 
. func ,type); 
return -1; 


} 
让 计算 出 次 设备 号 */ 
mutex_lock(&videodev_lock); 
if (nr >= 0 && nr « end-base) { 
/* use the one the driver asked for */ 
i = base+tnr; 
if (NULL != video device[i]) { 
mutex unlock(&videodev lock); 
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return -ENFILE; 
) 
}else { 
for(i=base;i<end;i++) 
if (NULL == video device[i]) 
break; 
if (i == end) { 
mutex_unlock(&videodev_lock); 
return -ENFILE; 
} 
} 
video device[i]-vfd; /保存 video_device 结构 指针 到 系统 的 结构 数组 中 , 最 终 的 次 设备 号 和 i 相关 
vfd->minor=i; 


mutex_unlock(&videodev_lock); 
mutex_init(&vfd->lock); 
memset(&vfd->class_dev, 0x00, sizeof(vfd-»class dev)); 
if (vid->dev) 
vfd->class_dev.parent = vfd-»dev; 
vfd->class_dev.class = &video_class; 
vfd->class_dev.devt = MKDEV(VIDEO MAJOR, vfd->minor); 
sprintf(vfd->class_dev.bus_id, "%s%d", name base, i - base);// 最 后 在 /dev 目录 下 的 名 称 
ret = device register(&vfd-»class dev);//£&& udev 或 mdev 可 以 实现 自动 在 /dev 下 创建 设备 节点 


} 
从 上 面 的 注册 函数 代码 中 可 以 看 出 , 注册 V4L2 驱动 的 过 程 只 是 创建 了 设备 节点 , 例如 /dev/video0， 
并 且 保 存 了 video_device 结构 指针 。 
(3) 打开 视频 驱动 。 
当 使 用 下 面 的 代码 在 用 户 空 间 调 用 open 函数 打开 对 应 的 视频 文件 时 ， 对 应 代码 如 下 : 
int fd = open(/dev/video0, O_RDWR); 
对 应 /dev/video0 目录 的 文件 操作 结构 是 在 文件 /drivers/media/videodev.c 中 定义 的 video fops, Ui 


如 下 Н 
static const struct file_operations video_fops= 
{ 
.owner = THIS MODULE, 
Лѕеек = no_llseek, 
.ореп = video_open, 
Е 


上 述 代码 只 是 实现 了 open 操作 ， 后 面 的 其 他 操作 需要 使 用 video_open0 来 实现 ， 有 具体 代码 如 下 : 
static int video open(struct inode *inode, struct file *file) 
{ 
unsigned int minor = iminor(inode); 
int err = 0; 
struct video_device *vfl; 
const struct file_operations *old_fops; 
if(minor>=VIDEO_NUM_DEVICES) 
return -ENODEV; 
mutex_lock(&videodev_lock); 
vfl=video_device[minor]; 
if(vfl==NULL) { 
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mutex_unlock(&videodev_lock); 
request_module("char-major-%d-%d", VIDEO_MAJOR, minor); 
mutex_lock(&videodev_lock); 
vfl=video_device[minor]; // 根 据 次 设备 号 取出 video device 结构 
if (vfl==NULL) { 

mutex_unlock(&videodev_lock); 

return -ENODEV; 
} 


5 
old fops = file->f_op; 
file-^f op = fops_get(vfl->fops);// 蔡 换 此 打开 文件 的 fle_operation 结构 。 后 面 的 其 他 针对 此 文 
件 的 操作 都 由 新 的 结构 来 负责 。 也 就 是 由 每 个 具体 的 video device 的 fops 负责 
if(file->f_op->open) 
err = file->f_op->open(inode file); 
if (err) { 
fops_put(file->f_op); 
file->f_op = fops_get(old_fops); 
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[Ж 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 15 章 \ 拍 照 系统 的 硬件 抽象 层 .avi 

在 Andorid 2.1 及 其 以 前 的 版 本 中 , Camera 系统 的 硬件 抽象 层 的 头 文件 保存 在 目录 frameworks/base/ 
include/ui/ 中 。 

在 Andorid 2.2 及 其 以 后 的 版 本 中 ，Camera 系统 的 硬件 抽象 层 的 头 文件 保存 在 目录 frameworks/av/ 
include/camera/ 中 。 

在 上 述 目录 中 主要 包含 了 如 下 头 文件 。 

E] CameraHardwareInterface.h: 在 里 面 定义 了 C++ 接口 类 , 此 类 需要 根据 系统 的 情况 来 实现 继承 。 

CameraParameters.h: 在 里 面 定 义 了 Camera 系统 的 参数 ， 可 以 在 本 地 系统 的 各 个 层次 中 使 用 

这 些 参数 。 
Camera.h: 在 里 面 提供 了 Camera 系统 本 地 对 上 层 的 接口 。 


15.3.1 Andorid 2.1 及 其 以 前 的 版 本 


在 Andorid 2.1 及 其 以 前 的 版 本 中 ， 在 文件 CameraHardwareInterface.h 中 首先 定义 了 硬件 抽象 层 接 
口 的 回调 函数 类 型 ， 对 应 的 代码 如 下 : 

/* startPreview() 使 用 的 回调 函数 */ 

typedef void (*preview_callback)(const sp<IMemory>& mem, void* user); 


/* startRecord() 使 用 的 回调 函数 */ 
typedef void (*recording_callback)(const sp<IMemory>& mem, void* user); 


/* takePicture() 使 用 的 回调 函数 */ 
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typedef void (*shutter_callback)(void* user); 


/* takePicture() 使 用 的 回调 函数 */ 
typedef void (*raw_callback)(const sp<IMemory>& mem, void* user); 


/* takePicture() 使 用 的 回调 函数 */ 
typedef void (*jpeg_callback)(const sp<IMemory>& mem, void* user); 


/** autoFocus() 使 用 的 回调 函数 */ 
typedef void (*autofocus callback)(bool focused, void* user); 
然后 定义 类 CameraHardwareInterface， 并 在 类 中 定义 各 个 接口 函数 。 具 体 代 码 如 下 : 
class CameraHardwarelnterface : public virtual RefBase { 
public: 
virtual - CameraHardwarelnterface() ( } 
virtual sp<IMemoryHeap>getPreviewHeap() const = 0; 
virtual sp<IMemoryHeap>getRawHeap() const = 0; 
virtual status t startPreview(preview callback cb, void* user) = 0; 
virtual bool useOverlay() (return false;} 
virtual status t setOverlay(const sp<Overlay> &overlay) (return BAD VALUE; 
virtual void stopPreview() 7 0; 
virtual bool previewEnabled() = 0; 
virtual status t startRecording(recording callback cb, void* user) 7 0; 
virtual void stopRecording() = 0; 
virtual bool recordingEnabled() 7 0; 
virtual void releaseRecordingFrame(const sp«IMemory»& mem) = 0; 
virtual status t autoFocus(autofocus callback, 
void* user) = 0; 
virtual status t takePicture(shutter callback, 
raw callback, 
jpeg callback, 
void* user) = 0; 
virtual status t cancelPicture(bool cancel shutter, 
bool cancel raw, 
bool cancel jpeg) = 0; 
virtual CameraParameters getParameters() const = 0; 
virtual void release() = 0; 
virtual status t dump(int fd, const Vector<String16>& args) const = 0; 
їй 
extern "C" sp<CameraHardwarelnterface> openCameraHardware(); 
k 
可 以 将 上 述 代 码 中 的 接口 分 为 如 下 几 类 。 
取景 预览 : startPreview、stopPreview、useOverlay 和 setOverlay。 
录制 视频 : startRecording、stopRecording、recordingEnabled 和 releaseRecordingFrame。 
M ”拍摄 照片 : takePicture 和 cancelPicture。 


辅助 功能 : autoFocus (自动 对 焦 )、setParameters 和 getParameters. 


15.3.2 Andorid 2.2 及 其 以 后 的 版 本 
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在 Andorid 2.2 及 其 以 前 的 版 本 中 , 在 文件 Camera.h 中 首先 定义 了 通知 信息 的 枚 举 值 ， 对 应 的 代码 
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如 下 : 


区 别 


епит { 
CAMERA_MSG_ERROR = 0х001, /| 错误 信息 
CAMERA_MSG_SHUTTER = 0x002, /快门 信息 
CAMERA_MSG_FOCUS = 0х004, /聚焦 信息 
CAMERA_MSG_ZOOM = 0x008, /| 缩放 信息 
CAMERA_MSG_PREVIEW_FRAME = 0x010, FRE Е А 
CAMERA_MSG_VIDEO_FRAME = 0х020, /视频 帧 信息 
CAMERA MSG POSTVIEW FRAME -0x040, /拍照 后 停止 帧 信息 
CAMERA_MSG_RAW_IMAGE = 0х080, /原始 数据 格式 照片 信息 
CAMERA_MSG_COMPRESSED_IMAGE = 0x100, // 压 缩 格 式 照片 信息 
CAMERA_MSG_ALL_MSGS = 0x1FF // 所 有 信息 
Е 
然后 在 文件 CameraHardwareInterface.h 中 定义 如 下 3 个 回调 函数 。 
// 通 知 回调 
typedef void (*notify callback)(int32 t msgType, 
int32 t ext1, 
int32 t ext2, 
void* user); 
/数据 回调 


typedef void (*data callback)(int32 t msgType, 
const sp<IMemory>& dataPtr, 
void* user); 
// 带 有 时 间 戳 的 数据 回调 
typedef void (*data_callback_timestamp)(nsecs_t timestamp, 
int32_t msgType, 
const sp<IMemory>& dataPtr, 
void* user); 
然后 定义 类 CameraHardwareInterface， 在 类 中 各 个 函数 的 具体 实现 和 其 他 Android 版 本 中 的 相同 。 
是 回调 函数 不 再 由 各 个 函数 分 别 设 置 ， 所 以 startPreview 和 startRecording 缺少 了 回调 函数 的 指针 


和 void* 类 型 的 附加 参数 。 主 要 实现 代码 如 下 : 


class CameraHardwarelnterface : public virtual RefBase { 
public: 
virtual -CameraHardwarelnterface() { } 
virtual sp<IMemoryHeap>getPreviewHeap() const = 0; 
virtual sp<IMemoryHeap>getRawHeap() const = 0; 
virtual void setCallbacks(notify_callback notify_cb, 
data_callback data_cb, 
data_callback_timestamp data_cb_timestamp, 
virtual void enableMsgType(int32_t msgType) = 0; 
virtual void disableMsgType(int32_t msgType) = 0; 
virtual bool msgTypeEnabled(int32_t msgType) = 0; 
virtual status_t startPreview() = 0; 
virtual status t getBufferlnfo(sp<IMemory>& Frame, size_t *alignedSize) = 0; 
virtual bool useOverlay() {return false;} 
virtual status t setOverlay(const sp<Overlay> &overlay) (return BAD VALUE;) 
virtual void stopPreview() 7 0; 
virtual bool previewEnabled() = 0; 
virtual status t startRecording() 7 0; 
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virtual void stopRecording() = 0; 
virtual bool recordingEnabled() = 0; 
virtual void releaseRecordingFrame(const sp«IMemory»& mem) = 0; 
virtual status t autoFocus() = 0; 
virtual status t cancelAutoFocus() = 0; 
virtual status t takePicture() = 0; 
virtual status t cancelPicture() = 0; 
virtual CameraParameters getParameters() const = 0; 
virtual status t sendCommand(int32 t cmd, int32 t arg1, int32 t arg2) = 0; 
virtual void release() = 0; 
virtual status t d 
) 
因为 在 新 版 本 的 Camera 系统 中 增加 了 sendCommand0， 所 以 需要 在 文件 Camera.h. 中 增加 新 命令 


和 返回 值 。 具 体 实现 代码 如 下 : 
/函数 sendCommand 使 用 的 命令 类 型 
епит { 
CAMERA_CMD_START_SMOOTH_ZOOM = 1, 
CAMERA_CMD_STOP_SMOOTH_ZOOM = 2, 
CAMERA_CMD_SET_DISPLAY_ORIENTATION = 3, 


Е 
// 错 误 类 型 
enum { 
CAMERA_ERROR_UKNOWN =1, 
CAMERA_ERROR_SERVER_DIED = 100 
k 


15.3.3 ”实现 Camera 硬件 抽象 层 


在 函数 startPreview 的 实现 过 程 中 ,保存 预览 回调 函数 并 建立 预览 线程 。 在 预览 线程 的 循环 中 ， 等 
待 视频 数据 的 到 达 ;， 视 频 帧 到 达 后 调用 预览 回调 函数 ， 将 视频 帧 送出 。 

取景 器 预览 的 主要 步骤 如 下 : 

СТ) 在 初始 化 的 过 程 中 ， 建 立 预览 数据 的 内 存 队列 《多 种 方式 )。 

(2) 在 函数 startPreview 中 建立 预览 线程 。 

(3) 在 预览 线程 的 循环 中 ， 等 待 视频 数据 到 达 。 

(4) 视频 到 达 后 使 用 预览 回调 机 制 将 视频 向 上 传送 。 

在 此 过 程 不 需要 使 用 预览 回调 函数 ， 可 以 直接 将 视频 数据 输入 到 Overlay E. 如 果 使 用 Overlay 
实现 取景 器 ， 则 需要 有 以 下 两 个 变化 : 

M 在 函数 setOverlay 中 ， 从 ISurface 接口 中 取得 Overlay 类 。 

M 在 预览 线程 的 循环 中 ， 不 是 用 预览 回调 函数 直接 将 数据 输入 到 Overlay 上 。 

录制 视频 的 主要 步骤 如 下 : 

(1) 在 函数 startRecording 的 实现 (或 者 在 setCallbacks ) 中 保存 录制 视频 回调 函数 。 

(2) 录制 视频 可 以 使 用 自己 的 线程 ， 也 可 以 使 用 预览 线程 。 

(3) 通过 调用 录制 回调 函数 的 方式 将 视频 帧 送出 。 

当 调用 函数 releaseRecordingFrame 后 ， 表 示 上 层 通知 Camera 硬件 抽象 层 ， 这 一 帧 的 内 存 已 经 用 
完 ， 可 以 进行 下 一 次 的 处 理 。 如 果 在 V4L2 驱动 程序 中 使 用 原始 数据 RAW)， 则 视频 录制 的 数据 和 取 
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景 器 预览 的 数据 为 同一 数据 。 当 调用 releaseRecordingFrame 时 ， 通 常 表 示 编 码 器 已 经 完成 了 对 当前 视频 
帧 的 编码 ， 对 这 块 内 存 进行 释放 。 在 这 个 函数 的 实现 中 ， 可 以 设置 标志 位 ， 标 记 帧 内 存 可 以 再 次 使 用 。 

由 此 可 见 ， 对 于 Linux 系统 来 说 ， 摄 像 头 驱动 部 分 大 多 使 用 Video for Linux 2 (V4L2) 驱动 程序 ， 
在 此 处 主要 的 处 理 流 程 如 下 : 

(1) 如 果 使 用 映射 内 核 内 存 的 方式 (V4L2 MEMORY MMAP)， 构 建 预览 的 内 存 MemoryHeap 
Base 需要 从 V4L2 驱动 程序 中 得 到 内 存 指针 。 

(2) 如 果 使 用 用 户 空间 内 存 的 方式 (V4L2 MEMORY USERPTR), MemoryHeapBase 中 开辟 的 
内 存 是 在 用 户 空 间 建立 的 。 

(3) 在 预览 的 线程 中 ， 使 用 VIDIOC_DQBUF 调用 阻塞 等 待 视频 帧 的 到 来 ， 处 理 完 成 后 使 用 
VIDIOC_QBUF 调用 将 帧 内 存 再 次 压 入 队列 ， 然 后 等 待 下 一 帧 的 到 来 。 
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Фи 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 15 章 \ 拍 照 系统 的 Java 部 分 .avi 
在 文件 packages/apps/Camera/src/com/android/camera/Camera.java 中 , 已 经 包含 了 对 Camera 的 调用 。 
在 文件 Camera. java 中 包含 的 对 包 的 引用 的 代码 如 下 : 
import android.hardware.Camera.PictureCallback; 
import android.hardware.Camera.Size; 
然后 定义 类 Camera, 此 类 继承 了 活动 Activity 类 ,在 它 的 内 部 包含 了 一 个 android.hardware.Camera。 
对 应 代码 如 下 : 
public class Camera extends Activity implements View.OnClickListener, SurfaceHolder.Callback{ 
android.hardware.Camera mCameraDevice; 
} 
调用 Camera 功能 的 代码 如 下 : 
mCameraDevice.takePicture(mShutterCallback, mRawPictureCallback, mJpegPictureCallback); 
mCameraDevice.startPreview(); 
mCameraDevice.stopPreview(); 
startPreview. stopPreview 和 takePicture 等 接口 就 是 通过 Java 本 地 调用 (ЛП) 来 实现 的 。 文 件 
frameworks/base/core/java/android/hardware/Camera.java 提供 了 一 个 JAVA 类 Camera， 具 体 代码 如 下 : 
public class Camera { 
} 
在 类 Camera 中 ， 大 部 分 代码 使 用 JNI 调用 下 层 得 到 ， 例 如 下 面 的 代码 。 
public void setParameters(Parameters params) { 
Log.e(TAG, "setParameters()"); 
//params.dump(); 
native setParameters(params.flatten()); 


} 

还 有 下 面 的 代码 。 

public final void setPreviewDisplay(SurfaceHolder holder) { 
setPreviewDisplay(holder.getSurface()); 

ү 


private native final void setPreviewDisplay(Surface surface); 
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在 上 面 的 两 段 代码 中 , 两 个 setPreviewDisplay 参数 不 同 , 后 一 个 是 本 地 方法 , 参数 为 Surface 类 型 ， 
前 一 个 通过 调用 后 一 个 实现 ， 但 自己 的 参数 以 SurfaceHolder 为 类 型 。 
(1) Camera 的 Java 本 地 调用 部 分 
在 Android 系统 中 ,Camera 驱动 的 Java 本 地 调用 (JNI) 部 分 在 文件 frameworks/base/core/jni/android_ 
hardware Camera.cpp 中 实现 。 
在 文件 android_hardware Camera.cpp 中 定义 了 一 个 JNINativeMethod (Java 本 地 调用 方法 ) 类 型 的 
数组 gMethods， 具 体 代码 如 下 : 
static JNINativeMethod camMethods[] = { 
(native setup","(Ljava/lang/Object;)V",(void*)android hardware Camera native setup }, 
(native release","()V",(void*)android hardware Camera release }, 
{"setPreviewDisplay","(Landroid/view/Surface;)V" (void *)апагоіа hardware Camera setPreviewDisplay }, 
{"startPreview","()V",(void *)android hardware Camera startPreview }, 
{"stopPreview", "()V", (void *)android hardware Camera stopPreview }, 
{"setHasPreviewCallback","(Z)V",(void *)android hardware Camera setHasPreviewCallback }, 
("native autoFocus","()V".(void *)android hardware Camera autoFocus }, 
("native takePicture", "()V", (void *)android hardware Camera takePicture }, 
{"native_setParameters","(Ljava/lang/String;)V",(void *Jandroid hardware Camera setParameters }, 
("native getParameters", "()Ljava/lang/String;" (void *)android hardware Camera getParameters } 
k 
JNINativeMethod 的 第 一 个 成 员 是 一 个 字符 串 ， 表 示 Java 本 地 调用 方法 的 名 称 ， 此 名 称 是 在 Java 
程序 中 调用 的 名 称 ， 第 二 个 成 员 也 是 一 个 字符 串 ， 表 示 Java 本 地 调用 方法 的 参数 和 返回 值 ， 第 三 个 成 
员 是 Java 本 地 调用 方法 对 应 的 C 语言 函数 。 
通过 函数 register_android_hardware_Camera() 将 gMethods 注册 为 android/media/Camera 的 类 ， 其 主 
要 实现 代码 如 下 : 
int register_android_hardware_Camera(JNIEnv *env) 
{ 
return AndroidRuntime::registerNativeMethods(env, "android/hardware/Camera",camMethods, NELEM(cam 
Methods)); 
} 
其 中 类 android/hardware/Camera 和 Java Ж android.hardware.Camera 相对 应 。 
(2) Camera 的 本 地 库 libui.so 
文件 frameworks/base/libs/ui/Camera.cpp 用 于 实现 文件 Camerah 中 提供 的 接口 , 其 中 最 重要 的 代码 


sp<Camera> Camera::create(const sp«ICamera»& camera) 


ALOGV("create"); 

if (camera == 0) { 
ALOGE("camera remote is a NULL pointer"); 
return 0; 


} 


sp<Camera> c = new Camera(-1); 

if (camera->connect(c) == NO_ERROR) { 
c->mStatus = NO_ERROR; 
c->mCamera = camera; 
camera->asBinder()->linkToDeath(c); 
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return c; 
} 
return 0; 
} 
函数 connect0 的 实现 代码 如 下 : 
sp<Camera> Camera::connect(int camerald, const String16& clientPackageName, 
int clientUid) 
{ 
return CameraBaseT::connect(camerald, clientPackageName, clientUid); 
} 


函数 connectO 通 过 调用 getCameraService 得 到 一 个 ICameraService， 再 通过 ICameraService 的 
cs->connect(c) 得 到 一 个 ICamera 类 型 的 指针 。 调 用 connect0 函 数 会 得 到 一 个 Camera 类 型 的 指针 。 在 
正常 情况 下 ， 已 经 初始 化 完成 了 Camera 的 成 员 mCamera. 

函数 startPreview0 的 实现 代码 如 下 : 

status_t Camera::startPreview() 


{ 
ALOGV('startPreview"); 


sp «ICamera» c = mCamera; 
if (c == 0) return NO INIT; 
return c->startPreview(); 


) 

其 他 函数 的 实现 过 程 也 与 函数 setDataSource 类 似 。 在 库 libmedia.so 中 的 其 他 一 些 文件 与 头 文件 的 
名 称 相同 ， 分 别 如 下 。 

frameworks/base/libs/ui/ICameraClient.cpp 

frameworks/base/libs/ui/ICamera.cpp 

frameworks/base/libs/ui/ICameraService.cpp 

此 处 的 类 BnCameraClient 和 BnCameraService 虽然 实现 了 onTransactOPR AL, (HJ Н T3443 21 Wl ВЯ 
数 没 有 实现 ， 所 以 不 能 实例 化 这 个 类 。 

(3) Camera 服务 libcameraservice.so 

目录 frameworks/av/services/camera/libcameraservice/ 实 现 一 个 Camera 的 服务 ， 此 服务 是 继承 
ICameraService 的 具体 实现 。 在 此 目录 下 和 硬件 抽象 层 “ 桩 ”实现 相关 的 文件 说 明 如 下 所 示 。 

М CameraHardwareStub.cpp: Camera 硬件 抽象 层 “ 桩 ”实现 。 

EJ CameraHardwareStub.h: Camera 硬件 抽象 层 “ 桩 ”实现 的 接口 。 

CannedJpeg.h: 包含 一 块 JPEG 数据 ， 在 拍照 片 时 作为 JPEG 数据 。 

FakeCamera.h 和 FakeCamera.cpp: 实现 假 的 Camera 黑白 格 取 景 器 效果 。 

在 文件 Android.mk 中 ， 使 用 宏 USE CAMERA STUB 决定 是 否 使 用 真 的 Camera， 如 果 宏 为 真 ， 
则 使 用 CameraHardwareStub.cpp 和 FakeCamera.cpp 构造 一 个 假 的 Camera; 如 果 为 假 ， 则 使 
CameraService.cpp 构造 一 个 实际 上 的 Camera 服务 。 文 件 Android.mk 的 主要 代码 如 下 : 

LOCAL MODULE:= libcamerastub 

LOCAL SHARED LIBRARIES:= libui 

include $(BUILD_STATIC_LIBRARY) 

endif# USE CAMERA STUB 


# 
# libcameraservice 
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include $(CLEAR_VARS) 
LOCAL_SRC_FILES:=\ 

CameraService.cpp 
LOCAL_SHARED_LIBRARIES:= \ 

libui V 

libutils V 

libcutils V 

libmedia 

LOCAL MODULE:-- libcameraservice 

LOCAL_CFLAGS+=-DLOG_TAG=\"CameraService\" 

ifeq ($(USE_CAMERA_STUB), true) 

LOCAL_STATIC_LIBRARIES += libcamerastub 

LOCAL_CFLAGS += -include CameraHardwareStub.h 

else 

LOCAL SHARED LIBRARIES += libcamera 

endif 

include $((BUILD SHARED LIBRARY) 

文件 CameraService.cpp 继承 了 BnCameraService 的 实现 ,在 此 类 内 部 又 定义 了 类 Client, CameraService:: 
Client 继承 了 BnCamera。 在 运作 的 过 程 中 , 函数 CameraService::connectO 用 于 得 到 一 个 CameraService:: 
Client. 在 使 用 过 程 中 , 主要 是 通过 调用 这 个 类 的 接口 来 实现 完成 Camera 的 功能 。 因 为 CameraService:: 
Client 本 身 继 承 了 BnCamera 类 ， 而 BnCamera 类 继承 了 ICamera， 所 以 可 以 将 此 类 当成 ICamera 来 使 用 。 

类 CameraService 和 CameraService::Client 的 结果 如 下 : 

class CameraService : public BnCameraService 

{ 

class Client : public ВпСатега {}; 

wp<Client> mClient; 

) 

在 CameraService 中 ， 静 态 函 数 instantiate0 用 于 初始 化 一 个 Camera 服务 ， 此 函数 的 代码 如 下 : 

void CameraService::instantiate() { 

defaultServiceManager()->addService( String16("media.camera"), new CameraService()); 

} 

其 实 函 数 CameraService::instantiate() Е T — + 44 PK media.camera 的 服务 ， 此 服务 和 文件 
Camera.cpp 中 调用 的 名 称 相 对 应 。 

Camera 整个 运作 机 制 是 : 在 文件 Camera.cpp 中 调用 ICameraService 的 接口 ， 此 时 实际 上 调用 的 是 
BpCameraService。 而 BpCameraService 通过 Binder 机 制 和 BnCameraService 实现 两 个 进程 的 通信 。 因 
为 BpCameraService 的 实现 就 是 此 处 的 CameraService, 所 以 Camera.cpp 虽然 是 在 另外 一 个 进程 中 运行 ， 
但 是 调用 ICameraService 的 接口 就 像 直 接 调用 一 样 ， 从 函数 connect0 中 可 以 得 到 一 个 ICamera 类 型 的 
指针 ， 整 个 指针 的 实现 实际 上 是 CameraService::Client。 

Е Camera 功能 的 具体 实现 就 是 CameraService::Client 所 实现 的 ， 其 构造 函数 如 下 : 

CameraService::Client::Client(const sp<CameraService>& cameraService, 

const sp<ICameraClient>& cameraClient) : 

mCameraService(cameraService), mCameraClient(cameraClient), mHardware(0) 

{ 

mHardware = openCameraHardware(); 

mHasFrameCallback = false; 
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在 构造 函数 中 ， 通 过 调用 openCameraHardware() 得 到 一 个 CameraHardwarelnterface 类 型 的 指针 ， 
并 作为 其 成 员 mHardware。 以 后 对 实际 的 Camera 的 操作 都 通过 这 个 指针 进行 ， 这 是 一 个 简单 的 直接 调 
用 关系 。 

其 实 真正 的 Camera 功能 已 经 通过 实现 CameraHardwareInterface 类 来 完成 。 在 这 个 库 中 ， 文 件 
CameraHardwareStub.h 和 CameraHardwareStub.cpp 定义 了 一 个 “ 桩 ”模块 的 接口 ， 可 以 在 没有 Camera 
硬件 的 情况 下 使 用 。 例 如 在 仿真 器 的 情况 下 使 用 的 文件 就 是 CameraHardwareStub.cpp 和 它 依赖 的 文件 
FakeCamera.cpp 。 

类 CameraHardwareStub 的 结构 如 下 : 


class CameraHardwareStub : public CameraHardwarelnterface { 
class PreviewThread : public Thread { 


Ë 
y 
在 类 CameraHardwareStub 中 包含 了 线程 类 PreviewThread， 此 线程 可 以 处 理 PreView， 即 负责 刷新 
取景 器 的 内 容 。 实 际 的 Camera 硬件 接口 通常 可 以 通过 对 V4L2 捕获 驱动 的 调用 来 实现 ， 同 时 还 需要 一 
个 РЕС 编码 程序 将 从 驱动 中 取出 的 数据 编码 成 JPEG 文件 。 
在 文件 FakeCamera.h 和 FakeCamera.cpp 中 实现 了 类 FakeCamera， 用 于 实现 一 个 假 的 摄像 头 输入 
数据 的 内 存 。 定 义 代码 如 下 : 
class FakeCamera { 
public: 
FakeCamera(int width, int height); 
~FakeCamera(); 


void setSize(int width, int height); 

void getNextFrameAsRgb565(uint16_t *buffer); IIR RR RGB565 格式 的 预览 帧 
void getNextFrameAsYuv422(uint8_t *buffer); RRQ Yuv422 格式 的 预览 帧 
status t dump(int fd, const Vector<String16>& args); 


private: 
void drawSquare(uint16 t *buffer, int x, int y, int size, int color, int shadow); 
void drawCheckerboard(uint16 t *buffer, int size); 


static const int KRed = Oxf800; 
static const int KGreen = 0х07с0; 
static const int kBlue = 0x003e; 


int mWidth, mHeight; 
int mCounter; 
int mCheckX, mCheckY; 
uint16_t *mTmpRgb16Buffer; 
k 
当 在 CameraHardwareStub 中 设置 参数 后 会 调用 函数 initHeapLocked0， 此 函数 的 实现 代码 如 下 : 
void CameraHardwareStub::initHeapLocked() 
nl 
int picture width, picture height; 
mParameters.getPictureSize(&picture width, &picture height); 
/建立 内 存 堆 栈 ， 创 建 两 块 内 存 
mRawHeap = new MemoryHeapBase(picture_width * 2 * picture_height); 
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int preview_width, preview_height; 
mParameters.getPreviewSize(&preview_width, &preview_height); 
LOGD("initHeapLocked: preview size=%dx%d", preview width, preview height); 


/从 参数 中 获取 信息 
int how_big = preview_width * preview_height * 2; 


if (how big == mPreviewFrameSize) 
return; 


mPreviewFrameSize = how big; 


mPreviewHeap = new MemoryHeapBase(mPreviewFrameSize * kBufferCount); 
/建立 内 存 队列 
for (int i = 0; i < kBufferCount; i++) { 
mBuffers[i] = new MemoryBase(mPreviewHeap, i * mPreviewFrameSize, mPreviewFrameSize); 


} 


delete mFakeCamera; 

mFakeCamera = new FakeCamera(preview_width, preview_height); 
} 
定义 函数 startPrevie() 来 创建 一 个 线程 ， 此 函数 的 实现 代码 如 下 : 
status_t CameraHardwareStub::startPreview(preview_callback cb, void* user) 
{ 

Mutex::Autolock lock(mLock); 

if (mPreviewThread != 0) { 

return INVALID OPERATION; 
} 


mPreviewCallback = cb; 
mPreviewCallbackCookie = user; 
mPreviewThread = new PreviewThread(this); /建立 视频 预览 线程 
return NO ERROR; 
) 
通过 上 面 建立 的 线程 可 以 调用 预览 回调 机 制 ， 将 预览 的 数据 传递 给 上 层 的 CameraService. 
创建 预览 线程 函数 previewThread0， 建 立 一 个 循环 以 得 到 假 的 摄像 头 输入 数据 的 来 源 ， 并 通过 预 
览 回调 函数 将 输出 传 到 上 层 中 去 。 函 数 previewThread0 的 主要 实现 代码 如 下 : 


int CameraHardwareStub::previewThread() 


mLock.lock(); 
int previewFrameRate = mParameters.getPreviewFrameRate(); 
/计算 在 当前 缓冲 堆 之 内 的 垂 距 
ssize_t offset = mCurrentPreviewFrame * mPreviewFrameSize; 
sp<MemoryHeapBase> heap = mPreviewHeap; 
/假设 照相 机 内 部 状态 没有 变化 
/Kor is thread safe) 
FakeCamera* fakeCamera = mFakeCamera; 
sp<MemoryBase> buffer = mBuffers[mCurrentPreviewFrame]; 
mLock.unlock(); 
if (buffer != 0) { 


/计算 在 框架 之 间 等 待 多 久 
@ 


ase avoennnee | 
int delay = (int)(1000000.0f / float(previewFrameRate)); 


/设置 为 总 是 合法 操作 ， 即 使 内 存 消亡 仍然 在 操作 过 程 中 被 映射 
void *base = heap->base(); 
/添加 模拟 照相 框架 
uint8_t *frame = ((uint8_t *)base) + offset; 
fakeCamera-»getNextFrameAsYuv422(frame); 


/一 个 新 客户 通知 框架 
mPreviewCallback(buffer, mPreviewCallbackCookie); 
// 推 进 缓冲 
mCurrentPreviewFrame = (mCurrentPreviewFrame + 1) % kBufferCount; 
NERC... 
usleep(delay); 


} 
return NO_ERROR; 
} 
在 上 述 文件 中 还 定义 了 其 他 的 函数 ， 函 数 的 功能 一 看 便 知 ， 在 此 为 节省 本 书 篇 幅 将 不 再 一 一 进行 
详细 讲解 ， 请 读者 参考 开源 的 代码 文件 。 


15.5 开发 拍照 应 用 程序 


Фа 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 15 章 \ 开 发 拍照 应 用 程序 .avi 
在 开发 Android 应 用 程序 的 过 程 中 ， 有 如 下 两 种 方式 可 以 调用 系统 的 摄像 头 实现 拍照 功能 。 
通过 Intent 调用 系统 的 照相 机 Activity。 

通过 编码 调用 Camera API。 

本 节 将 详细 讲解 上 述 两 种 方式 的 具体 实现 流程 。 


15.5.1 通过 Intent 调用 系统 的 照相 机 Activity 


在 现实 中 的 很 多 应 用 场景 中 ， 都 需要 使 用 摄像 头 去 拍摄 照片 或 视频 ， 然 后 在 照片 或 视频 的 基础 之 
上 进行 处 理 。 但 是 因为 Android 系统 源码 是 开源 的 ， 所 以 很 多 设备 厂商 均 可 使 用 ， 造 成 定制 比较 混乱 
的 状况 发 生 。 一 般 来 说 ， 在 需要 用 到 摄像 头 拍照 或 摄像 时 ， 均 会 直接 调用 系统 现 有 的 相机 应 用 去 进行 
拍照 或 摄像 ， 我 们 只 取 它 拍摄 的 结果 进行 处 理 ， 这 样 就 避免 了 不 同 设备 的 摄像 头 的 一 些 细 节 问 题 。 

当 通 过 Intent 直接 调用 系统 提供 的 照相 机 功能 时 ， 复 用 其 拍照 Activity 是 最 简单 和 最 方便 的 办 法 ， 
此 时 不 需要 考虑 手机 的 兼容 性 问题 ， 如 预览 拍照 图 片 大 小 等 。 例 如 下 面 的 演示 代码 。 

Intent i = new Intent("android.media.action.IMAGE_CAPTURE"); 

startActivityForResult(i, C REQUEST_CODE_CAMERA); 

然后 通过 如 下 所 示 的 代码 在 onActivityResult 中 获取 返回 的 数据 。 

if(resultCode==RESULT_OK){ 

Bundle extras = data.getExtras(); 


if(extras!=null){ 
Bitmap bitmap = (Bitmap) extras.get(C.CODE PHOTO BITMAP DATA); 


} 
} 


Быел 


但 是 通过 上 述 过 程 这 样 获取 的 图 片 是 缩小 过 的 ， 如 果 要 获取 原始 的 相片 ， 则 需要 在 调用 时 就 指定 
相片 生成 的 路 径 。 例 如 下 面 的 演示 代码 。 
i.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(tempPath))); 


然后 指定 相片 的 类 型 ， 例 如 下 面 的 演示 代码 。 
i.putExtra("outputFormat", Bitmap.CompressFormat.PNG.name()); 


也 可 以 设置 拍照 的 横竖 屏 ， 例 如 下 面 的 演示 代码 。 
i.putExtra( MediaStore.EXTRA_SCREEN_ORIENTATION,Configuration.ORIENTATION_LANDSCAPE); 


15.5.2 ”调用 Camera API 拍照 


除了 调用 内 置 的 拍照 系统 之 外 ， 还 可 以 直接 调用 摄像 头 的 API 来 编写 类 似 取景 框 的 拍照 Activity， 
这 种 方式 更 加 灵活 。 但 需要 考虑 底层 的 具体 结构 ， 需 要 了 解 Android 的 版 本 、 摄 像 头 的 分 辨 率 组 合 等 
信息 ， 这 样 才能 够 编写 出 各 种 屏幕 分 辨 率 组 合 的 布局 等 。 

另外 ，Android 提供 的 SDK (android.hardware.Camera) 不 能 正常 地 使 用 竖 屏 (Portrait Layout) 加 
载 照 相机 ， 当 用 竖 屏 模式 加 载 照相 机 时 会 产生 如 下 问题 。 

照相 机 成 像 左 倾 90”。 

照相 机 成 像 长 宽 比 例 不 对 《〈 失 比 )。 

造成 上 述 问题 的 原因 是 摄像 头 对 照 物 的 映射 是 Android 底层 固定 的 ， 以 landscape 方式 为 正 ， 并 且 
产生 大 小 为 320x480 的 像 。 此 时 可 以 通过 编写 自 定义 代码 来 校正 上 述 问题 ， 具 体 编码 思路 如 下 。 

(1) 设置 Camera 的 参数 来 实现 转变 图 片 预 览 角度 , 但 这 种 方式 并 不 是 对 所 有 的 Camera 都 有 效果 
的 。 例 如 下 面 的 演示 代码 。 

Camera.Parameters parameters = camera.getParameters(); 

parameters.set("orientation", "portrait"); 


parameters.set("rotation", 90); 
camera.setParameters(parameters); 


(2) 在 获取 拍摄 相片 之 后 进行 旋转 校正 ， 但 是 如 果 图 片 太 大 会 造成 内 存 溢出 的 问题 。 例 如 下 面 的 
演示 代码 。 
Matrix m = new Matrix(); 
m.postRotate(90); 
m.postScale(balance, balance); 
Bitmap.createBitmap(tempBitmap, 0, 0, tempBitmap.getWidth(), tempBitmap.getHeight(),m, true); 
在 Android 系统 中 ， 当 通过 Camera АРІ 方式 实现 拍照 功能 时 ， 需 要 用 到 如 下 所 示 的 类 。 
(1) Camera 类 : 最 主要 的 类 ， 用 于 管理 Camera 设备 ， 常 用 的 方法 如 下 。 
open): 通过 该 方法 获取 Camera 实例 。 
setPreviewDisplay(SurfaceHolder): 设置 预览 拍照 。 
startPreview(): 开始 预览 。 
stopPreviewQ: 停止 预览 。 
release(): 释放 Camera 实例 。 
takePicture(Camera.ShutterCallback shutter, Camera.PictureCallback raw, Camera.PictureCallback 
jpeg): 这 是 拍照 要 执行 的 方法 , 包含 了 3 个 回调 参数 。 其 中 参数 shutter 是 快门 按 下 时 的 回调 ， 
参数 raw 是 获取 拍照 原始 数据 的 回调 ， 参 数 jpeg 用 来 获取 压缩 成 jpg 格式 的 图 像 数 据 。 
Camera.PictureCallback 接口 :该 回调 接口 包含 了 一 个 onPictureTaken(byte[]data, Camera camera) 
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方法 。 在 这 个 方法 中 可 以 保存 图 像 数 据 。 
(2) SurfaceView Ж: 用 于 控制 预览 界面 。 其 中 SurfaceHolder.Callback 接口 用 于 处 理 预 览 的 事件 ， 
需要 实现 如 下 所 示 的 3 个 方法 。 

surfaceCreated(SurfaceHolderholder): 预览 界面 创建 时 调用 ， 每 次 界面 改变 后 都 会 重新 创建 ， 
需要 获取 相机 资源 并 设置 SurfaceHolder。 

surfaceChanged(SurfaceHolderholder, int format, int width, int height): 在 预览 界面 发 生变 化 时 调 
用 ， 每 次 界面 发 生变 化 之 后 需要 重新 启动 预览 。 

surfaceDestroyed(SurfaceHolderholder): 预览 销毁 时 调用 ， 停 止 预览 ， 释 放 相 应 资源 。 


15.5.3 ”总结 Camera 拍照 的 流程 


经 过 本 节 前 面 内 容 的 介绍 ,想必 大 家 对 Camera 拍照 的 基本 知识 有 了 一 个 全 新 的 了 解 。 在 此 根据 笔 
者 的 开发 经 验 ,总 结 出 使 用 Camera 实现 拍照 应 用 的 基本 流程 , 希望 为 广大 读者 起 到 一 个 抛砖引玉 的 作用 。 

СТ) 如 果 想 在 自己 的 应 用 中 使 用 摄像 头 ， 需 要 在 AndroidManifest.xml 中 增加 以 下 权限 声明 代码 。 

<uses-permissionandroid:name="android.permission.CAMERA"/> 

(2) 设 定 摄像 头 布局 。 

这 一 步 是 开发 工作 的 基础 ， 也 就 是 说 我 们 希望 在 应 用 程序 中 增加 多 少 辅助 性 元 素 ， 如 摄像 头 各 种 
功能 按钮 等 。 这 里 采取 最 简 方 式 ， 除 了 拍照 外 ， 没 有 多 余 摄像 头 功 能 。 布 局 文件 camera_surface.xml 


介绍 如 下 : 

<LinearLayoutxmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="fill_parent"android:layout_height="fill_parent" 
androidrientation="vertical"> 
<SurfaceViewandroid:id="@+id/surface_camera" 
android:layout_width="fill_parent"android:layout_height="10dip" 
android:layout_weight="1"> 
</SurfaceView> 

</LinearLayout> 


在 此 不 要 在 资源 文件 名 称 中 使 用 大 写字 母 ， 如 果 把 该 文件 命名 为 CameraSurface.xml， 会 带 来 不 必 
要 的 麻烦 。 

上 述 布局 非常 简单 ， 只 有 一 个 LinearLayout 视图 组 ， 在 它 下 面 只 有 一 个 SurfaceView 视图 ， 也 就 是 
摄像 头 屏幕 。 

(3) 编写 摄像 头 实 现代 码 。 

在 此 创建 一 个 名 为 CameraView 的 Activity 类 ， 实 现 SurfaceHolder.Callback 接口 。 

publicclassCamaraViewextendsActivityimplementsSurfaceHolder.Callback 

接口 SurfaceHolder.Callback 被 用 来 接收 摄像 头 预览 界面 变化 的 信息 ， 它 实现 了 如 下 3 个 方法 。 

surfaceChanged: 当 预 览 界面 的 格式 和 大 小 发 生 改变 时 ， 该 方法 被 调用 。 

surfaceCreated: 在 初次 实例 化 、 预 览 界 面 被 创建 时 ， 该 方法 被 调用 。 

surfaceDestroyed: 当 预 览 界 面 被 关闭 时 ， 该 方法 被 调用 。 

接 下 来 看 一 下 在 摄像 头 应 用 中 如 何 使 用 这 个 接口 ， 首 先 看 一 下 在 Activity 类 中 的 onCreate0 方 法 ， 
其 中 通过 下 面 的 代码 设置 摄像 头 预览 界面 将 通过 全 屏 显 示 ， 并 且 没 有 “标题 title)”， 并 设置 屏幕 格式 
为 “ 半 透 明 ”。 

getWindow().setFormat(PixelFormat.TRANSLUCENT); 

requestWindowFeature(Window.FEATURE NO TITLE); 
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getWindow().setFlags(WindowManager.LayoutParams.FLAG FULLSCREEN, 

WindowManager.LayoutParams.FLAG FULLSCREEN); 

然后 通过 setContentView 来 设 定 Activity 的 布局 为 前 面 我 们 创建 的 camera_surface， 并 创建 一 个 
SurfaceView 对 象 ， 从 xml 文件 中 获得 它 。 对 应 代码 如 下 : 

setContentView(R.layout.camera_surface); 

mSurfaceView=(SurfaceView)findViewByld(R.id.surface_camera); 

mSurfaceHolder=mSurfaceView.getHolder(); 

mSurfaceHolder.addCallback(this); 

mSurfaceHolder.setType(SurfaceHolder. SURFACE_TYPE_PUSH_BUFFERS); 

通过 以 上 代码 从 surfaceview 中 获得 了 holder， 并 增加 callback 功能 到 this。 这 意味 着 我 们 的 操作 

(Activity) 可 以 管理 这 个 surfaceview. 

再 看 Callback 功能 的 实现 代码 : 

publicvoidsurfaceCreated(SurfaceHolderholder){ 

mCamera=Camera.open(); 

上 面 的 mCamera 是 Camera 类 的 一 个 对 象 。 在 surfaceCreated() 方 法 中 “打开 ”摄像 头 。 这 就 是 启 
动 它 的 方式 。 

接 下 来 定义 方法 surfaceChangedO0 让 摄像 头 做 好 拍照 准备 ， 设 定 它 的 参数 ， 并 开始 在 Android 屏幕 
中 启动 预览 画面 。 在 此 使 用 了 semaphore 参数 来 防止 冲突 : 当 mPreviewRunning 为 tue 时 ， 意 味 着 摄 
像 头 处 于 激活 状态 ， 并 未 被 关闭 ， 因 此 我 们 可 以 使 用 它 。 

public void surfaceChanged(SurfaceHolderholder intformat,intw,inth)( 


if(mPreviewRunning)( 
mCamera.stopPreview(); 


Camera.Parametersp=mCamera.getParameters(); 
p.setPreviewSize(w,h); 
mCamera.setParameters(p); 
try 
mCamera.setPreviewDisplay(holder); 
Jcatch(IOExceptione)( 
e.printStackTrace(); 

} 

mCamera.startPreview(); 

mPreviewRunning=true; 

} 
publicvoidsurfaceDestroyed(SurfaceHolderholder){ 

mCamera.stopPreview(); 

mPreviewRunning-false; 

mCamera.release(); 


} 
通过 上 述 方法 代码 停止 了 摄像 头 , 并 释放 相关 的 资源 。 正 如 大 家 所 看 到 的 , 在 此 设置 mPreviewRunning 
J false 以 防止 在 surfaceChanged 方法 中 的 冲突 。 这 是 因为 我 们 已 经 关闭 了 摄像 头 ， 而 且 不 能 再 设置 其 
参数 或 在 摄像 头 中 启动 图 像 预 览 。 
最 后 看 下 面 最 重要 的 方法 : 
Camera.PictureCallbackmPictureCallback=newCamera.PictureCallback(){ 
publicvoidonPictureTaken(byte[]imageData,Camerac)( 
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在 拍照 时 该 方法 被 调用 。 例 如 可 以 在 界面 上 创建 一 个 OnClickListener， 当 点 击 屏 幕 时 调用 
PictureCallBack() 方 法 , 此 方法 会 提供 图 像 的 字 节 数 组 , 然后 使 用 Android 提供 的 Bitmap 和 BitmapFactory 
类 ， 将 其 从 字 节 数组 转换 成 想 要 的 图 像 格式 。 


15.6 解析 二 维 码 


ГЮ 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 15 章 \ 解 析 二 维 码 .avi 

QR Code 码 是 由 日 本 Denso 公司 于 1994 年 9 月 研制 的 一 种 矩阵 二 维 码 符号 , 它 具 有 一 维 条 码 及 其 
他 二 维 条 码 所 具有 的 信息 容量 大 、 可 靠 性 高 、 可 表示 汉字 及 图 像 等 多 种 信息 、 保 密 防 伪 性 强 等 优点 。 
本 节 将 详细 讲解 使 用 相机 解析 QR Code 码 的 方法 。 


15.6.1 QR Code 码 的 特点 


从 QR Code 码 的 英文 名 称 Quick Response Code 可 以 看 出 ， 超 高 速 识 读 特点 是 QR Code 码 区 别 于 
四 一 七 条 码 、Data Matrix 等 二 维 码 的 主要 特性 。 由 于 在 用 CCD 识 读 QR Code 码 时 ， 整 个 QR Code 码 
符号 中 信息 的 读 取 是 通过 QR Code 码 符号 的 位 置 探测 图 形 ， 用 硬件 来 实现 ， 因 此 ， 信 息 识 读 过 程 所 需 
时 间 很 短 ， 它 具有 超 高 速 识 读 特 点 。 用 CCD 二 维 条 码 识 读 设备 ， 每 秒 可 识 读 30 个 含有 100 个 字符 的 
QR Code 码 符 号 ; 对 于 含有 相同 数据 信息 的 四 一 七 条 码 符号 , 每 秒 仅 能 识 读 3 个 符号 ; 对 于 Data Martix 
矩阵 码 ， 每 秒 仅 能 识 读 2 一 3 个 符号 。QR Code 码 的 超 高 速 识 读 特 性 ， 使 它 能 够 广泛 应 用 于 工业 自动 化 
生产 线 管理 等 领域 。 

QR Code 码 具 有 全 方位 (360° ) 识 读 特点 , 这 是 QR Code 码 优 于 行 排 式 二 维 条 码 如 四 一 七 条 码 的 
另 一 主要 特点 ， 由 于 四 一 七 条 码 是 通过 将 一 维 条 码 符号 在 行 排 高 度 上 的 截 短 来 实现 的 ， 因 此 ， 它 很 难 
实现 全 方位 识 读 ， 其 识 读 方位 角 仅 为 土 /0”， 能 够 有 效 地 表示 中 国 汉 字 和 日 本 汉字 。 由 于 QR Code lË 
用 特定 的 数据 压缩 模式 表示 中 国 汉字 和 日 本 汉字 ， 它 仅 用 13bit 即 可 表示 一 个 汉字 ， 而 四 一 七 条 码 、 
Data Martix 等 二 维 码 没有 特定 的 汉字 表示 模式 ， 因 此 仅 用 字 节 表示 模式 来 表示 汉字 ， 在 用 字 节 模式 表 
示 汉 字 时 ， 需 用 16bit (两 个 字 节 ) 表示 一 个 汉字 ， 因 此 QR Code 码 比 其 他 的 二 维 条 码 表示 汉字 的 效率 
提高 了 20%. 


15.6.2 ”实战 演练 一 一 使 用 Android 相机 解析 二 维 码 
下 面 将 通过 一 个 具体 实例 来 讲解 使 用 Android 相机 解析 QR Code 二 维 码 的 方法 。 


H | HH m" | 源码 路 径 
实例 15-1 |... f& FH Android 相机 解析 QR Code 二 维 码 光盘 :\daima\15\qrEX 


本 实例 的 具体 实现 流程 如 下 。 
OD 分 别 创建 入 有 Camera 对 象 mCamera01. mButton01. mButton02 和 mButton03， 然 后 设置 默 


认 相 机 预览 模式 为 false。 具 体 代 码 如 下 : 
/创建 私有 Camera WR 
private Camera mCamera01; 
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private Button mButton01, mButton02, mButton03; 
/作为 review 照 下 来 的 相片 之 用 */ 

private ImageView mlmageViewO01; 

private String TAG = "HIPPO"; 

private SurfaceView mSurfaceView01; 

private SurfaceHolder mSurfaceHolder01; 


/默认 相机 预览 模式 为 false*/ 
private boolean blfPreview = false; 
(2) 设置 应 用 程序 全 屏幕 运行 ， 并 添加 红色 正方 形 红 框 View 供用 户 对 准 条 形 码 ， 然 后 将 创建 的 
红色 方 框 添加 至 Activity 中 。 具 体 代 码 如 下 : 
public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedinstanceState); 
/使 应 用 程序 全 屏幕 运行 ， 不 使 用 title bar*/ 
requestWindowFeature(Window.FEATURE_NO_TITLE); 
setContentView(R.layout.main); 
/添加 红色 正方 形 红 框 View， 供 User 对 准 条 形 码 */ 
DrawCaptureRect mDraw = new DrawCaptureRect 


example203.this, 

110, 10, 100, 100, 

getResources().getColor(R.drawable.lightred) 
y 


/将 创建 的 红色 方 框 添加 至 Activity 中 */ 
addContentView 


( 
mDraw, 
new LayoutParams 


( 
LayoutParams.WRAP CONTENT, LayoutParams. WRAP CONTENT 


) 
y 
(3) 分 别 取 得 屏幕 解析 像素 ， 绑 定 SurfaceView 并 设置 预览 大 小 。 具 体 代 码 如 下 : 
/* 取 得 屏幕 解析 像素 */ 
DisplayMetrics dm = new DisplayMetrics(); 
getWindowManager().getDefaultDisplay().getMetrics(dm); 


mlmageView01 = (ImageView) findViewByld(R.id.mylmageView1); 


/以 SurfaceView 作为 相机 Preview 之 用 */ 
mSurfaceView01 = (SurfaceView) findViewByld(R.id.mSurfaceView1); 


[$Æ SurfaceView， 取 得 SurfaceHolder x1 $&*/ 
mSurfaceHolder01 = mSurfaceView01.getHolder(); 


[Activity 必须 实现 SurfaceHolder.Callback*/ 
mSurfaceHolder01.addCallback(example203.this); 


б 


we axeennree ОООО. 


”额外 的 预览 大 小 设置 ， 在 此 不 使 用 */ 
lImSurfaceHolder01.setFixedSize(320, 240); 


r 
* Д SURFACE_TYPE_PUSH_BUFFERS(3) 

* 作为 SurfaceHolder 显示 类 型 

+] 

mSurfaceHolder01.setType 
(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS); 


mButton01 = (Button)findViewByld(R.id.myButton1); 
mButton02 = (Button)findViewByld(R.id.myButton2); 
mButton03 = (Button)findViewByld(R.id.myButton3); 
(4) 编写 单 击 方法 mButton01 按钮 的 响应 程序 ， 单 击 后 打开 相机 及 预览 二 维 条 形 码 。 具 体 代 码 如 下 : 
/* 打 开 相 机 及 预览 二 维 条 形 码 */ 
mButton01.setOnClickListener(new Button.OnClickListener() 
{ 
@Override 
public void onClick(View argO) 
{ 


/* 自 定义 初始 化 打开 相机 函数 沁 
їпїСатега(); 
} 
» 
C5) 编写 方法 单 击 mButton02 按钮 的 响应 程序 ， 单 击 后 停止 预览 。 具 体 代码 如 下 : 
PLE FRYE") 
mButton02.setOnClickListener(new Button.OnClickListener() 
{ 
@Override 
public void onClick(View argO) 
{ 


让 自 定义 重 置 相机 ， 并 关闭 相机 预览 函数 */ 
resetCamera(); 
} 
р; 
(6) 编写 单 击 mButtond3 按钮 后 的 响应 程序 , 单 击 后 拍照 处 理 并 生成 二 维 条 形 码 。 具体 代码 如 下 : 
ЗАВ QR Code 二 维 条 形 码 */ 
mButton03.setOnClickListener(new Button.OnClickListener() 


@Override 
public void onClick(View arg0) 


{ 
Be MARA) 
takePicture(); 
} 
ba 
} 
(7) 定义 方法 initCamera0 用 于 自 定义 初始 相机 函数 ， 具 体 代码 如 下 : 
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ГАХ УЛ" 
private void initCamera() 


{ 
if(!blfPreview) 


{ 
A* 车 相机 不 是 在 预览 模式 ， 则 打开 相机 */ 
mCamera01 = Сатега.ореп(); 


} 


if (тСатега01 != null && !blfPreview) 


{ 


Log.i(TAG, "inside the camera"); 


/创建 Camera.Parameters 对 象 */ 
Camera.Parameters parameters = mCamera01.getParameters(); 


/设置 相片 格式 为 JPEG*/ 
parameters.setPictureFormat(PixelFormat.JPEG); 


/指定 preview 的 屏幕 大 小 */ 
parameters.setPreviewSize(160, 120); 


FREE ATHE ANI 
parameters.setPictureSize(160, 120); 


/将 Camera.Parameters 设置 于 Camera*/ 
mCamera01.setParameters(parameters); 


/*setPreviewDisplay 唯一 的 参数 为 SurfaceHolder*/ 
mCamera01.setPreviewDisplay(mSurfaceHolder01); 


/立即 运行 Preview*/ 
mCamera01.startPreview(); 
bifPreview = true; 
} 
} 
(8) 定义 方法 takePicture0 用 于 拍照 并 获取 图 像 。 具 体 代 码 如 下 : 
”拍照 搬 取 图 像 */ 
private void takePicture() 
{ 
if (mCamera01 != null && blfPreview) 
! MAA takePicture() 方 法 拍照 */ 
mCamera01.takePicture 
(shutterCallback, rawCallback, jpegCallback); 
1: 
} 
(9) 定义 方法 resetCamera() 实 现 相 机 重 置 ， 然 后 释放 Camera 对 象 。 具 体 代 码 如 下 : 
"相机 重 置 */ 
private void resetCamera() 


(m 


2158 greennnee V T 


{ 


if (mCamera01 != null && blfPreview) 
{ 
mCamera01.stopPreview(); 
1 释放 Camera WR */ 
ИтСатега01 .геіеаѕе(); 
mCamera01 = null; 
bifPreview = false; 
} 
} 
private ShutterCallback shutterCallback = new ShutterCallback() 
{ 
public void onShutter() 
{ 
} 


} 
private PictureCallback rawCallback = new PictureCallback() 
{ 
public void onPictureTaken(byte[] _data, Camera _camera) 
{ 
} 
5 
(10) 定义 方法 onPictureTaken()， 对 传 入 的 图 片 进行 处 理 。 首 先 设置 onPictureTaken 传 入 的 第 一 
个 参数 即 为 相片 的 byte; 然后 使 用 Matrix.postScale 方法 缩小 图 像 大 小 ; 接 下 来 创建 新 的 Bitmap 对 象 ; 
然后 获取 4:3 图 片 的 居中 红色 框 部 分 100X 100 像素 ， 并 将 拍照 的 图 文件 以 ImageView 显示 出 来 ; 最 后 
将 传 入 的 图 文件 译 码 成 字符 串 ， 并 定义 方法 mMakeTextToast0 输 出 提示 。 具 体 代 码 如 下 : 
private PictureCallback jpegCallback = new PictureCallback() 
{ 
public void onPictureTaken(byte[] data, Camera camera) 
{ 
try 
{ 
/*onPictureTaken() 传 入 的 第 一 个 参数 即 为 相片 的 byte*/ 
Bitmap bm = 
BitmapFactory.decodeByteArray( data, 0, _data.length); 


int resizeWidth = 160; 

int resizeHeight = 120; 

float scaleWidth = ((float) resizeWidth) / bm.getWidth(); 
float scaleHeight = ((float) resizeHeight) / bm.getHeight(); 


Matrix matrix = new Matrix(); 
/使 用 Matrix.postScale 方法 缩小 Bitmap Size*/ 
matrix.postScale(scaleWidth, scaleHeight); 


/创建 新 的 Bitmap x1$*/ 
Bitmap resizedBitmap = Bitmap.createBitmap 
(bm, 0, 0, bm.getWidth(), bm.getHeight(), matrix, true); 


ТНА 4:3 图 片 的 居中 红色 框 部 分 100X 100 像素 */ 


‘цикл 


Bitmap resizedBitmapSquare = Bitmap.createBitmap 
(resizedBitmap, 30, 10, 100, 100); 


/* 将 拍照 的 图 文件 以 ImageView 显示 出 来 */ 
mlmageViewO1.setlmageBitmap(resizedBitmapSquare); 


”将 传 入 的 图 文件 译 码 成 字符 囊 */ 
String strQR2 = decodeQRImage(resizedBitmapSquare); 
if(strQR2!="") 


{ 
if (URLUtil.isNetworkUrl(strQR2)) 


{ 
OMIA 规范 ， 网 址 条 形 码 ， 打 开 浏 览 器 上 网 */ 
mMakeTextToast(strQR2, true); 
Uri mUri = Uri.parse(strQR2); 
Intent intent = new Intent(Intent.ACTION VIEW, mUri); 
startActivity(intent); 


} 
else if(eregi("wtai://",strQR2)) 


OMIA 规范 ， 手 机 拨打 电话 格式 */ 
String[] aryTemp01 = strQR2.split("wtai://"); 
Intent myIntentDial = new Intent 


"android.intent.action.CALL", 
Uri.parse("tel:"+aryTemp01[1]) 


); 
startActivity(myIntentDial); 
} 
else if(eregi("TEL:",strQR2)) 


{ 
OMIA 规范 ， 手 机 拨打 电话 格式 */ 
String[] aryTemp01 = strQR2.split("TEL:"); 
Intent myIntentDial = new Intent 


( 
"android.intent.action.CALL", 


Uri.parse("tel:"+aryTemp01[1]) 
y 

startActivity(myIntentDial); 
) 


else 


{ 
BREF, ПД Toast 显示 出 来 */ 
mMakeTextToast(strQR2, true); 
} 
} 


nce, USSR, HAMM 
resetCamera(); 


”再 重新 启动 相机 继续 预览 */ 


@ 


we axeennaee ОООО. 


initCamera(); 
Los (Exception e) 
: Log.e(TAG, e.getMessage()); 
: ) 
х 


public void mMakeTextToast(String str, boolean isLong) 
if(isLong==true) 


Toast.makeText(example203.this, str, Toast.LENGTH LONG).show(); 
} 


else 


Toast.makeText(example203.this, str, Toast.LENGTH SHORT).show(); 
} 
} 
(11) 定义 方法 checkSDCard0 来 判断 记忆 卡 是 否 存在 。 具 体 代码 如 下 : 
private boolean checkSDCard() 
{ 
"判断 记忆 卡 是 否 存在 */ 
if(android.os.Environment.getExternalStorageState().equals 
(android.os.Environment. MEDIA MOUNTED)) 
{ 
return true; 
} 
else 
{ 
return false; 
} 
} 
(12) 定义 方法 decodeQRImage(Bitmap myBmp) 来 解码 传 入 的 Bitmap 图 片 ， 主 要 代码 如 下 : 
让 解码 传 入 的 Bitmap 图 片 */ 
public String decodeQRImage(Bitmap myBmp) 
{ 
String strDecodedData = ""; 
try 
{ 
QRCodeDecoder decoder = new QRCodeDecoder(); 
strDecodedData = new String 
(decoder.decode(new AndroidQRCodelmage(myBmp))); 
} 
catch(Exception e) 
{ 
e.printStackTrace(); 


} 
return strDecodedData; 
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(13) 定义 类 DrawCaptureRect 来 绘制 相机 预览 画面 中 的 正方 形 方 框 。 具 体 代 码 如 下 : 
A/* 绘 制 相机 预览 画面 中 的 正方 形 方 框 */ 
class DrawCaptureRect extends View 
{ 
private int colorFill; 
private int intLeft,intTop,intWidth, intHeight; 


public DrawCaptureRect 

( 
Context context, int intX, int intY, int intWidth, 
int intHeight, int colorFill 

) 

Í 
super(context); 
this.colorFill = colorFill; 
this.intLeft = intX; 
this.intTop = intY; 
this.intWidth = intWidth; 
this.intHeight = intHeight; 

} 


@Override 
protected void onDraw(Canvas canvas) 
Í 
Paint mPaint01 = new Paint(); 
mPaint01.setStyle(Paint.Style.FILL); 
mPaint01.setColor(colorFill); 
mPaint01.setStrokeWidth(1.0F); 
/在 画布 上 绘制 红色 的 4 条 方 边框 作为 瞄准 器 */ 
canvas.drawLine 
( 
this.intLeft, this.intTop, 
this.intLeft+intWidth, this.intTop, mPaint01 
); 
canvas.drawLine 
( 
this.intLeft, this.intTop, 
this.intLeft, this.intToptintHeight, mPaint01 
); 
canvas.drawLine 
( 
this.intLeft+intWidth, this.intTop, 
this.intLeft+intWidth, this.intTop*intHeight, mPaint01 
) 
canvas.drawLine 
( 
this.intLeft, this.intTop-*intHeight, 
this.intLeft+intWidth, this.intTop+intHeight, mPaint01 
ji 


第 15 章 条 形 码 解 析 技 术 详解 


super.onDraw(canvas); 
} 
} 
(14) 定义 方法 eregi0 实 现 自 定义 比较 字符 串 处 理 。 具 体 代 码 如 下 : 
人 * 自 定义 比较 字符 串 函 数 */ 
public static boolean eregi(String strPat, String strUnknow) 
{ 
String strPattern = "(?i)"+strPat; 
Pattern р = Pattern.compile(strPattern); 
Matcher m = p.matcher(strUnknow); 
return m.find(); 


} 


@Override 
public void surfaceChanged 
(SurfaceHolder surfaceholder, int format, int w, int h) 


{ 
Log.i(TAG, "Surface Changed"); 


} 


@Override 
public void surfaceCreated(SurfaceHolder surfaceholder) 


{ 
Log.i(TAG, "Surface Changed"); 


} 


@Override 
public void surfaceDestroyed(SurfaceHolder surfaceholder) 


{ 
Log.i(TAG, "Surface Destroyed"); 


} 


@Override 
protected void onPause() 
í 


super.onPause(); 


} 


} 
执行 后 能 够 通过 手机 拍照 的 方式 实现 二 维 码 解析 ， 如 图 15-3 所 示 。 
we) ЧАК #3 4:010m 


图 15-3 执行 效果 
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NFC 是 近 场 通信 (Near Field Communication) 的 缩写 ， 此 技术 由 非 接触 式 射频 识别 (RFID) 演变 
而 来 ， 由 飞利浦 半导体 ( 现 恩 智 浦 半导体 )、 诺 基 亚 和 索尼 共同 研制 开发 ， 其 基础 是 RFID 及 互联 技术 。 
NFC 是 一 种 短 距 高 频 的 无 线 电 技术 , 在 13.56MHz 频率 运行 于 20 厘米 距离 内 。 其 传输 速度 有 106kbit/s、 
212kbit/s 或 者 424kbit/s 3 种 。 目 前 近 场 通信 已 成 为 ISO/IEC IS 18092 国际 标准 、.ECMA-340 标准 和 ETSI 
TS 102 190 标准 。NFC 采用 主动 和 被 动 两 种 读 取 模 式 。 本 章 将 详细 讲解 在 Android 设备 中 使 用 近 场 通 
信 技 术 的 基本 知识 ， 为 步 入 本 书后 面 知识 的 学 习 打 下 基础 。 


16.1 近 场 通信 技术 基础 


GH 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 16 章 \ 近 场 通信 技术 基础 .avi 

NEC 近 场 通信 技术 由 非 接 触 式 射频 识别 (RFID) 及 互联 互通 技术 整合 演变 而 来 ， 在 单一 芯片 上 结 
合 感应 式 读 卡 器 、 感 应 式 卡片 和 点 对 点 的 功能 ， 能 在 短 距 离 内 与 兼容 设备 进行 识别 和 数据 交换 。 工 作 
频率 为 13.56MHz， 但 是 使 用 这 种 手机 支付 方案 的 用 户 必 须 更 换 特制 的 手机 。 目 前 这 项 技术 在 日 、 韩 被 
广泛 应 用 。 手 机 用 户 赁 着 配置 了 支付 功能 的 手机 就 可 以 行 遍 全 国 : 他 们 的 手机 可 以 用 作 机 场 登 机 验证 、 
大 厦 的 门禁 钥匙 、 交 通 一 卡通 、 信 用 卡 、 支 付 卡 等 。 本 节 将 简要 讲解 NFC 技术 的 基本 知识 。 


16.1.1 МЕС 技术 的 特点 


近 场 通信 是 基于 RFID 技术 发 展 起 来 的 一 种 近 距 离 无 线 通信 技术 。 与 RFID 一 样 , 近 场 通信 信息 也 
是 通过 频谱 中 无 线 频率 部 分 的 电磁 感应 耦合 方式 传递 ， 但 两 者 之 间 还 是 存在 很 大 的 区 别 。 近 场 通信 的 
传输 范围 比 RFID 小 , RFID 的 传输 范围 可 以 达到 0 一 lm, 但 由 于 近 场 通信 采取 了 独特 的 信号 衰减 技术 ， 
相对 于 RFID 来 说 近 场 通信 具有 成 本 低 、 带 宽 高 、 能 耗 低 等 特点 。 

在 现实 应 用 中 ， 近 场 通信 技术 的 主要 特征 如 下 : 
用 于 近 距 离 (10cm UA) 安全 通信 的 无 线 通信 技术 。 
射频 频率 : 13.56MHz。 
射频 兼容 : ISO 14443 和 ISO 15693, Felica 标准 。 
数据 传输 速度 : lO6kbit/s. 212kbit/s 或 424kbit/s。 


16.1.2 NFC 的 工作 模式 


在 现实 应 用 中 ，NFC 技术 有 如 下 所 示 的 3 种 工作 模式 。 
M FS (Card emulation): 此 模式 其 实 就 是 相当 于 一 张 采用 RFID 技术 的 IC F. п МКА 
在 大 量 的 IC 卡 (包括 信 用 卡 ) 使 用 的 场合 ， 如 商场 刷卡 、 公 交 卡 、 门 禁 管 制 、 车 票 、 门 票 等 。 
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此 种 方式 下 有 一 个 极 大 的 优点 , 那 就 是 卡片 通过 非 接触 读 卡 器 的 RF 域 来 供电 , 即便 是 寄主 设 
备 ( 如 手机 ) 没 电 也 可 以 工作 。 

点 对 点 模式 (P2P mode): 此 模式 和 红外 线 差不多 ， 可 用 于 数据 交换 ， 只 是 传输 距离 较 短 ， 传 
输 创建 速度 较 快 ， 传 输 速度 也 快 ， 功 耗 低 〈 蓝 牙 也 类 似 )。 将 两 个 具备 NFC 功能 的 设备 链接 ， 
能 实现 数据 点 对 点 传输 ， 如 下 载 音乐 、 交 换 图 片 或 者 同步 设备 地 址 短 。 因 此 通过 NFC， 多 个 
设备 如 数位 相机 、PDA、 计 算 机 和 手机 之 间 都 可 以 交换 资料 或 者 服务 。 

读 卡 器 模式 CReader/writer mode): 作为 非 接触 读 卡 器 使 用 ， 可 以 从 海报 或 者 展览 信息 电子 标 

签 上 读 取 相 关 信 息 。 


16.1.3 МЕС 和 蓝牙 的 对 比 


在 现实 应 用 中 ，NFC 和 蓝牙 (Bluetooth) 都 是 短程 通信 技术 ， 而 且 都 被 集成 到 移动 电话 。 但 МЕС 
不 需要 复杂 的 设置 程序 ， 并 且 也 可 以 简化 蓝牙 连接 。NEFC 略 胜 蓝牙 的 地 方 在 于 设置 程序 较 短 ， 但 无 法 
达到 低 功率 蓝牙 (Bluetooth Low Energy) 的 速度 。 在 两 台 NFC 设备 相互 连接 的 识别 过 程 中 ， 使 用 NFC 
来 替代 人 工 设置 会 使 创建 连接 的 速度 大 大 加 快 ， 会 少 于 十 分 之 一 秒 。 

NEC 的 最 大 数据 传输 量 是 424kbit/s， 这 远 小 于 Bluetooth V2.1 (2.1Mbit/s)。 虽 然 NFC 在 传输 速度 
与 距离 方面 比 不 上 Bluetooth, 但 是 NFC 技术 不 需要 电源 , 对 于 移动 电话 或 是 移动 消费 性 电子 产品 来 说 ， 
NFC 的 使 用 比较 方便 。NFC 的 短 距离 通信 特性 正 是 其 优点 ， 由 于 耗 电量 低 、 一 次 只 和 一 台 机 器 链接 ， 
拥有 较 高 的 保密 性 与 安全 性 ，NFC 有 利于 信用 卡 交易 时 避免 被 盗用 。NFC 的 目标 并 非 是 取代 蓝牙 等 其 
他 无 线 技术 ， 而 是 在 不 同 的 场合 、 不 同 的 领域 起 到 相互 补充 的 作用 。 

МЕС 技术 和 蓝牙 技术 主要 功能 参数 的 对 比如 表 16-1 所 示 。 

表 16-1 NFC 技术 和 蓝牙 技术 主要 功能 参数 的 对 比 
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说 明 МЕС Bluetooth Bluetooth Low Епег; 
RFID 兼容 ISO 18000-3 active active 
标准 化 机 构 ISO/IEC Bluetooth SIG Bluetooth SIG 
网 络 标准 ISO 13157 etc. IEEE 802.15.1 IEEE 802.15.1 
网 络 类 型 Point-to-point WPAN WPAN 
加 密 not with RFID available available 
范围 «02m ~10m (class 2) -1m (class 3) 
频率 13.56MHz 2.4~2.5GHz 2.4~2.5GHz 
Bit rate 424kbit/s 2.1Mbit/s ~1.0Mbit/s 
设置 程序 < 0.15 «6s «1s 
功 耗 <15mA (read) varies with class < 15mA (xmit) 
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射频 识别 即 RFID (Radio Frequency Identification) 技术 ， 又 称 无 线 射 频 识别 ， 是 NFC 技术 的 一 个 
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TÆ. RFID 是 一 种 通信 技术 ， 可 以 通过 无 线 电信 号 识别 特定 目标 并 读 写 相关 数据 ， 而 无 须 识别 系统 与 
特定 目标 之 间 建 立 机 械 或 光学 接触 。 在 现实 中 常用 的 RFID 技术 有 低频 (125 一 134.2kHz)、 高 频 
(13.56MHz)、 超 高 频 、 微 波 等 技术 。RFID 读 写 器 也 分 移动 式 和 固定 式 ， 目 前 RFID 技术 应 用 很 广 ， 
例如 ， 图 书馆 、 门 禁 系 统 和 食品 安全 溯源 等 。 本 节 将 详细 讲解 射频 识别 技术 RFID 的 基本 知识 。 


16.2.1 RFID 技术 简介 


RFID 是 一 种 无 线 通信 技术 ， 可 以 通过 无 线 电信 号 识别 特定 目标 并 读 写 相 关 数 据 ， 而 无 须 识别 系统 
与 特定 目标 之 间 建 立 机 械 或 者 光学 接触 。 从 概念 上 来 讲 ，RFID 类 似 于 条 码 扫描 ， 对 于 条 码 技术 而 言 ， 
它 是 将 已 编码 的 条 形 码 附着 于 目标 物 ， 并 使 用 专用 的 扫描 读 写 器 利用 光 信 号 将 信息 由 条 形 磁 传 送 到 扫 
描 读 写 器 ;而 RFID 则 使 用 专用 的 RFID 读 写 器 及 专门 的 可 附着 于 目标 物 的 REID 标签 ， 利 用 频率 信号 
将 信息 由 RFID 标签 传送 至 RFID 读 写 器 。 

无 线 电 的 信号 是 通过 调 成 无 线 电 频率 的 电磁 场 ， 把 数据 从 附着 在 物品 上 的 标签 上 传送 出 去 ， 以 自 
动 辨 识 与 追踪 该 物品 。 某 些 标签 在 识别 时 从 识别 器 发 出 的 电磁 场 中 就 可 以 得 到 能 量 ， 并 不 需要 电池 ; 
也 有 标签 本 身 拥有 电源 ， 并 可 以 主动 发 出 无 线 电波 〈 调 成 无 线 电 频率 的 电磁 场 )。 标 签 包含 了 电子 存储 
的 信息 ， 数 米 之 内 都 可 以 识别 。 与 条 形 码 不 同 的 是 ， 射 频 标签 不 需要 处 在 识别 器 视线 之 内 ， 也 可 以 巾 
入 被 追踪 物体 之 内 。 

在 现实 应 用 中 ， 有 许多 行业 都 运用 了 射频 识别 技术 。 将 标签 附着 在 一 辆 正在 生产 中 的 汽车 上 ， 生 
产 者 可 以 追踪 此 车 在 生产 线 上 的 进度 。 仓 库 可 以 追踪 药品 的 所 在 。 射 频 标签 也 可 以 附 于 牲畜 与 宠物 上 ， 
方便 对 牲畜 与 宠物 的 积极 识别 (积极 识别 意思 是 防止 数 只 牲畜 使 用 同一 个 身份 )。 射 频 识别 的 身份 识别 
卡 可 以 使 员工 得 以 进入 锁 住 的 建筑 部 分 ， 汽 车 上 的 射频 应 答 器 也 可 以 用 来 征收 收费 路 段 与 停车 场 的 
费用 。 

某 些 射频 标签 附 在 衣物 、 个 人 财物 上 ， 甚 至 于 植 入 人 体内 。 由 于 这 项 技术 可 能 会 在 未 经 本 人 许可 
的 情况 下 读 取 个 人 信息 ， 所 以 这 项 技术 也 会 有 侵犯 个 人 隐私 的 忧患 。 


16.2.2 RFID 技术 的 组 成 


从 结构 上 讲 RFID 是 一 种 简单 的 无 线 系统 ， 只 有 两 个 基本 器 件 ， 该 系统 用 于 控制 、 检 测 和 跟踪 物 
体 。 系 统 由 一 个 询问 器 和 很 多 应 答 器 组 成 。 在 最 初 的 技术 领域 中 ， 应 答 器 是 指 能 够 传输 信息 、 回 复 信 
息 的 电子 模块 。 近 年 来 ， 由 于 射频 技术 发 展 迅猛 ， 应 答 器 有 了 新 的 说 法 和 含义 ， 又 被 叫做 智能 标签 或 
标签 。RFID 电子 标签 的 阅读 器 通过 天 线 与 RFID 电子 标签 进行 无 线 通信 ， 可 以 实现 对 标签 识别 码 和 内 
存 数据 的 读 出 或 写 入 操作 。RFID 技术 可 识别 高 速 运动 物体 并 可 同时 识别 多 个 标签 ， 操 作 快捷 方便 。 

伴随 着 RFID 技术 的 不 断 发 展 ， 其 具体 组 成 如 下 。 
М WARS: 由 天 线 、 耦 合 元 件 及 芯片 组 成 ， 一 般 来 说 都 是 用 标签 作为 应 答 器 ， 每 个 标签 具有 唯 
一 的 电子 编码 ， 附 着 在 物体 上 标识 目标 对 象 。 

М ”阅读 器 : HARA. BATHE RE HA, BER (有 时 还 可 以 写 入 ) 标签 信息 的 设备 ， 可 设计 
为 手持 式 REID 读 写 器 (如 C5000W) 或 固定 式 读 写 器 。 

M ”应 用 软件 系统 : 是 应 用 层 软 件 ， 主 要 是 把 收集 的 数据 进一步 处 理 ， 并 为 人 们 所 使 用 。 
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16.2.3 RFID 技术 的 特点 


射频 识别 系统 最 重要 的 优点 是 非 接触 识别 ， 它 能 穿 透 雪 、 雾 、 冰 、 涂 料 、 尘 垢 和 条 形 码 无 法 使 用 
的 恶劣 环境 阅读 标签 ， 并 且 阅 读 速度 极 快 ， 大 多 数 情况 下 不 到 100 毫秒 。 有 源 式 射频 识别 系统 的 速写 
能 力也 是 重要 的 优点 。 可 用 于 流程 跟踪 和 维修 跟踪 等 交互 式 业务 。 

制约 射频 识别 系统 发 展 的 主要 问题 是 不 兼容 的 标准 。 射 频 识别 系统 的 主要 厂商 提供 的 都 是 专用 系 
统 ， 导 致 不 同 的 应 用 和 不 同 的 行业 采用 不 同 厂 商 的 频率 和 协议 标准 ， 这 种 混乱 和 割据 的 状况 已 经 制约 
了 整个 射频 识别 行业 的 增长 。 许 多 欧美 组 织 正在 着 手 解决 这 个 问题 ， 并 已 经 取得 了 一 些 成 绩 。 标 准 化 
必 将 刺激 射频 识别 技术 的 大 幅度 发 展 和 广泛 应 用 。 

RFID 技术 的 主要 特点 如 下 。 

M ”快速 扫描 : RFID 辨识 器 可 以 同时 辨识 读 取 数 个 RFID 标签 。 

体积 小 型 化 、 形 状 多 样 化 ，RFID 在 读 取 上 并 不 受 尺寸 大 小 与 形状 的 限制 ， 不 需 为 了 读 取 精确 
度 而 配合 纸张 的 固定 尺寸 和 印刷 品质 。 此 外 ，RFID 标签 更 可 向 小 型 化 与 多 样 形态 发 展 ， 以 应 
用 于 不 同 产品 。 

抗 污染 能 力 和 耐久 性 : 传统 条 形 码 的 载体 是 纸张 ， 因 此 容易 受到 污染 ， 但 RFID 对 水 、 油 和 
化 学 药品 等 物质 具有 很 强 的 抵抗 性 。 此 外 ， 由 于 条 形 码 附 于 塑料 袋 或 外 包装 纸箱 上 ， 所 以 特 
别 容易 受到 折 损 ;，RFID 卷 标 是 将 数据 存在 芯片 中 ， 因 此 可 以 免 受 污 损 。 

可 重复 使 用 : 当今 的 条 形 码 印刷 上 去 之 后 就 无 法 更 改 ，RFID 标签 则 可 以 重复 地 新 增 、 修 改 、 
删除 REID 卷 标 内 存储 的 数据 ， 方 便 信 息 的 更 新 。 

穿 透 性 和 无 屏障 阅读 : 在 被 覆盖 的 情况 下 ，RFID 能 够 穿 透 纸张 、 木 材 和 塑料 等 非 金 属 或 非 透 
明 的 材质 ， 并 能 够 进行 穿 透 性 通信 。 而 条 形 码 扫描 机 必须 在 近 距 离 而 且 没 有 物体 阻挡 的 情况 
下 才 可 以 辨 读 条 形 码 。 

数据 的 记忆 容量 大 : 一 维 条 形 码 的 容量 是 50Bytes， 二 维 条 形 码 最 大 的 容量 可 存储 2~3000 字 
ff. RFID 最 大 的 容量 则 有 数 MegaByteso。 随 着 记忆 载体 的 发 展 ， 数 据 容量 也 有 不 断 扩大 的 
趋势 。 未 来 物品 所 需 携 带 的 资料 量 会 越 来 越 大 ， 对 卷 标 所 能 扩充 容量 的 需求 也 相应 增加 。 

安全 性 : 由 于 RFID 承载 的 是 电子 式 信息 ， 其 数据 内 容 可 经 由 密码 保护 ， 使 其 内 容 不 易 被 伪 

造 及 变 造 。 

RFID 因 其 所 具备 的 远 距 离 读 取 、 高 存储 量 等 特性 而 备 受 瞩目 。 它 不 仅 可 以 帮助 一 个 企业 大 幅 提高 
货物 、 信 息 管理 的 效率 ， 还 可 以 让 销售 企业 和 制造 企业 互联 ， 从 而 更 加 准确 地 接收 反馈 信息 ， 控 制 需 
求 信息 ， 优 化 整个 供应 链 。 


16.24 RFID 技术 的 工作 原理 


RFID 技术 的 基本 工作 原理 是 : 当 标签 进入 磁场 后 ， 接 收 解读 器 发 出 的 射频 信号 ， 凭 借 感 应 电流 所 
获得 的 能 量 发 送出 存储 在 芯片 中 的 产品 信息 (Passive Tag， 无 源 标签 或 被 动 标签 )， 或 者 由 标签 主动 发 
送 某 一 频率 的 信号 (Active Tag， 有 源 标签 或 主动 标签 )， 解 读 器 读 取信 息 并 解码 后 ， 送 至 中 央 信 息 系 
统 进行 有 关 数 据 处 理 。 

一 套 完整 的 RFID 系统 由 阅读 器 (Reader)、 电 子 标签 (TAG, 也 就 是 所 谓 的 应 答 器 (Transponder)) 
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及 应 用 软件 系统 3 部 分 组 成 ,其 工作 原理 是 Reader 发 射 一 特定 频率 的 无 线 电 波 能 量 给 Transponder, 用 
以 驱动 Transponder 电路 将 内 部 的 数据 送出 ， 此 时 Reader 便 依 序 接收 解读 数据 ， 送 给 应 用 程序 做 相应 
的 处 理 。 

以 RFID 卡片 阅读 器 及 电子 标签 之 间 的 通信 及 能 量 感应 方式 来 看 , 可 以 大 致 上 将 RFID 分 成 感应 耦 
A (Inductive Coupling) 及 后 向 散射 耦合 (Backscatter Coupling) 两 种 。 通 常 低频 的 RFID 大 都 采用 第 
一 种 方式 ， 而 较 高 频 大 多 采用 第 二 种 方式 。 

阅读 器 根据 使 用 的 结构 和 技术 不 同 可 以 是 读 或 读 / 写 装置 ， 是 RFID 系统 信息 控制 和 处 理 中心 。 阅 
读 器 通常 由 耦合 模块 、 收 发 模块 、 控 制 模块 和 接口 单元 组 成 。 阅 读 器 和 应 答 器 之 间 一 般 采 用 半 双 工 通 
信和 方式 进行 信息 交换 ， 同 时 阅读 器 通过 耦合 给 无 源 应 答 器 提供 能 量 和 时 序 。 在 实际 应 用 中 ， 可 进一步 
通过 Ethernet 或 WLAN 等 实现 对 物体 识别 信息 的 采集 、 处 理 及 远程 传送 等 管理 功能 。 应 答 器 是 RFID 
系统 的 信息 载体 ， 应 答 器 大 多 是 由 耦合 元 件 〈 线 圈 、 微 带 天 线 等 ) 和 微 芯 片 组 成 无 源 单元 。 
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NFC 通信 总 是 由 一 个 发 起 者 (initiator) 和 一 个 接收 者 (target) 组 成 的 。 通 常 initiator 主动 发 送 电 

磁场 (RF) 为 被 动 式 接收 者 (passive target) 提供 电源 。 其 工作 的 基本 原理 和 收音 机 类 似 。 正 是 由 于 被 
动 式 接收 者 通过 发 起 者 提供 电源 ， 因 此 target 可 以 有 非常 简单 的 形式 ， 如 标签 、 卡 和 Sticker 的 形式 。 
另外 ，NFC 也 支持 点 到 点 的 通信 (peer to peer)， 此 时 参与 通信 的 双方 都 有 电源 支持 。 在 Android 系统 
的 NFC 模块 应 用 中 ，Android 手机 通常 是 作为 通信 中 的 发 起 者 ， 也 就 是 作为 NFC 的 读 写 器 。Android 
手机 也 可 以 模拟 作为 NFC 通信 的 接收 者 ， 并 且 从 Android 2.3.3 起 也 支持 P2P 通信 。Android 系统 支持 
如 下 所 示 的 NFC 标准 。 
NfcANFC-A (ISO 14443-3A) 
NfcBNFC-B (ISO 14443-3B) 
NfcFNFC-F (JIS 6319-4) 
NfcVNFC-V (ISO 15693) 
IsoDepISO-DEP (ISO 14443-4) 
MifareClassic 
MifareUltralight 
在 Android 系统 中 ，NFC 模块 结构 从 上 到 下 的 具体 说 明 如 下 所 示 。 

(1) /system/framework/framework jar 
android.nfe: 标准 接口 (NFCAdapter/NfcManager ). 
E] android.nfc.tech: 标签 技术 。 

(2) /system/Nfc.apk 
B comandroid.nfe: МЕС 服务 相关 。 
Ei .DeviceHos: 底层 设备 接口 原型 。 
М NfcService: Nfe 服务 实现 DeviceHostListener 接口 。 
M com.android.nfc.dhimpl: NFC 功能 底层 实现 -com.android.nfc.DeviceHost (МХР). 
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-NativeNfcManager: implements DeviceHost. 

JNI-» com android пёс NativeNfcManager.cpp (libnfc jni.so). 

-NativeNfcSecureElement. 

JNI-> com android пёс NativeNfcSecureElement.cpp (libnfc jni.so). 
(3) /system/lib/libnfc .so 

libnfc-nxp => libnfc.so, libnfc ndef.so. 

libnfc-nci => libnfc-nci.so. 


本 节 将 详细 讲解 Android 系统 中 NEC 模块 源码 的 基本 知识 。 
16.3.1 分 析 Java 层 


在 Android 系统 中 ，NFC 模块 的 Java 层 代码 位 于 目录 \frameworks\basevcoreiavavandroidmfc\ 中 。 

在 上 述 目录 中 ,包含 了 用 来 与 本 地 NFC 适配器 进行 交互 的 顶层 类 , 这 些 类 可 以 表示 被 检测 到 的 tags 
和 用 NDEF 数据 格式 。 在 МЕС 的 Java 层 中 ， 常 用 的 顶层 类 如 下 : 

(1) NfcManager 

Æ NfcManager fE Ж l'F/frameworks/base/core/java/android/nfc/NfcManager.java 中 定义 , 这 是 一 个 NFC 
Adapter 的 管理 器 ， 可 以 列 出 所 有 此 Android 设备 支持 的 NFC Adapter， 只 不 过 大 部 分 Android 设备 只 
有 一 个 NFC Adapter, 所 以 在 大 部 分 情况 下 可 以 直接 用 静态 方法 getDefaultAdapter(context) 来 取 适 配器 。 
文件 /frameworks/base/core/java/android/nfe/NfcManager.java 的 具体 实现 代码 如 下 : 


public final class NfcManager { 
private final NfcAdapter mAdapter; 


Же е | 


p 
* @hide 
4l 
public NfcManager(Context context) ( 
NfcAdapter adapter; 
context = context.getApplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 
"context not associated with any application (using a mock context?)"); 
} 


try { 
adapter = NfcAdapter.getNfcAdapter(context); 


} catch (UnsupportedOperationException e) { 
adapter = null; 
} 
mAdapter = adapter; 
} 


p 
* Get the default NFC Adapter for this device. 
* 

* @return the default МЕС Adapter 
af 
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public NfcAdapter getDefaultAdapter() { 
return mAdapter; 
} 
} 
(2) NfcAdapter 
ЖТЕ Ж fF /frameworks/base/core/java/android/nfc/NfcAdapter.java 中 定义 ， 此 类 表示 本 设备 的 МЕС 
Adapter， 可 以 定义 Intent 来 请 求 将 系统 检测 到 tags 的 提醒 发 送 到 我 们 的 Activity， 并 提供 方法 去 注册 前 
台 tag 提醒 发 布 和 前 台 NDEF 推送 。 前 台 NDEF 推送 是 当前 Android 版 本 唯一 支持 的 p2p NFC 通信 方式 。 
X f'F/frameworks/base/core/java/android/nfc/NfcA dapter.java 的 具体 实现 代码 如 下 : 
public final class NfcAdapter { 
static final String ТАС = "МЕС"; 
public static final String ACTION_NDEF_DISCOVERED = "android.nfc.action.NDEF_DISCOVERED"; 
@SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 
public static final String ACTION TECH DISCOVERED = "android.nfc.action. TECH_DISCOVERED"; 
(pSdkConstant(SdkConstantType.ACTIVITY INTENT ACTION) 
public static final String ACTION TAG DISCOVERED = "android.nfc.action. TAG. DISCOVERED"; 
public static final String ACTION TAG LEFT FIELD = "android.nfc.action. TAG LOST"; 
public static final String EXTRA. TAG = "android.nfc.extra. TAG"; 
public static final String EXTRA NDEF MESSAGES = "android.nfc.extra.NDEF MESSAGES"; 
public static final String EXTRA ID = "android.nfc.extra.ID"; 
(pSdkConstant(SdkConstantType.BROADCAST INTENT ACTION) 
public static final Sting ACTION ADAPTER STATE CHANGED = 
"android.nfc.action. ADAPTER STATE CHANGED" 
public static final String EXTRA ADAPTER STATE - "android.nfc.extra.ADAPTER STATE"; 


public static final int STATE OFF = 1; 

public static final int STATE TURNING ON = 2; 
public static final int STATE ON = 3; 

public static final int STATE TURNING OFF - 4; 


I @hide */ 
public static final int FLAG_NDEF_PUSH_NO_CONFIRM = 0x1; 


I** @hide */ 
public static final String ACTION HANDOVER TRANSFER STARTED = 
"android.nfc.action.HANDOVER TRANSFER STARTED"; 


1" @hide */ 
public static final String ACTION HANDOVER TRANSFER DONE - 
"android.nfc.action.HANDOVER TRANSFER DONE"; 


/** @hide */ 
public static final String EXTRA_HANDOVER_TRANSFER_STATUS = 
"android.nfc.extra.HANDOVER TRANSFER STATUS"; 


/** @hide */ 

public static final int HANDOVER_TRANSFER_STATUS_SUCCESS = 0; 
/** @hide */ 

public static final int HANDOVER_TRANSFER_STATUS_FAILURE = 1; 
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Р* @hide */ 
public static final String EXTRA_HANDOVER_TRANSFER_URI = 
"android.nfc.extra-HANDOVER TRANSFER. ВІ"; 


static boolean slsInitialized = false; 


static INfcAdapter sService; 

static INfcTag sTagService; 

static HashMap<Context, NfcAdapter> sNfcAdapters = new HashMap(); 
static NfcAdapter sNullContextNfcAdapter; 


final NfcActivityManager mNfcActivityManager; 
final Context mContext; 
public interface OnNdefPushCompleteCallback { 
public void onNdefPushComplete(NfcEvent event); 


} 
public interface CreateNdefMessageCallback { 
public NdefMessage createNdefMessage(NfcEvent event); 


public interface CreateBeamUrisCallback { 
public Uri[] createBeamUris(NfcEvent event); 


private static boolean hasNfcFeature() { 
IPackageManager рт = ActivityThread.getPackageManager(); 
if (pm == null) { 
Log.e(TAG, "Cannot get package manager, assuming no NFC feature"); 
return false; 
} 
try { 
return pm.hasSystemFeature(PackageManager.FEATURE NFC); 
} catch (RemoteException e) { 
Log.e(TAG, "Package manager query failed, assuming no NFC feature", e); 
return false; 
} 
} 
public static synchronized NfcAdapter getNfcAdapter(Context context) { 
if (!slsInitialized) ( 
if (hasNfcFeature()) { 
Log.v(TAG, "this device does not have NFC support"); 
throw new UnsupportedOperationException(); 


} 


sService = getServicelnterface(); 
if (SService == null) { 
Log.e(TAG, "could not retrieve NFC service"); 
throw new UnsupportedOperationException(); 
^ 
try { 
sTagService = sService.getNfcTagInterface(); 
} catch (RemoteException e) { 
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Log.e(TAG, "could not retrieve МЕС Tag service"); 
throw new UnsupportedOperationException(); 
} 


slsinitialized = true; 
} 
if (context == null) { 
if (sNullContextNfcAdapter == null) { 
sNullContextNfcAdapter = new NfcAdapter(null); 


} 
return sNullContextNfcAdapter; 


NfcAdapter adapter = sNfcAdapters.get(context); 
if (adapter == null) { 
adapter = new NfcAdapter(context); 
sNfcAdapters.put(context, adapter); 


return adapter; 


} 


/** get handle to NFC service interface */ 
private static INfcAdapter getServicelnterface() { 
IBinder b = ServiceManager.getService("nfc"); 
if (b == null) { 
return null; 


} 
return INfcAdapter.Stub.asInterface(b); 


} 
public static NfcAdapter getDefaultAdapter(Context context) { 
if (context == null) { 
throw new IllegalArgumentException("context cannot be null"); 
} 
context = context.getApplicationContext(); 
if (context == null) { 
throw new IllegalArgumentException( 
“context not associated with any application (using a mock context?)"); 
} 
/* use getSystemService() for consistency */ 
NfcManager manager = (NfcManager) context.getSystemService(Context.NFC_SERVICE); 
if (manager == null) { 


return null; 
} 
return manager.getDefaultAdapter(); 
} 
@Deprecated 


public static NfcAdapter getDefaultAdapter() { 
/lintroduced in API version 9 (GB 2.3) 
//deprecated in API version 10 (GB 2.3.3) 
/Iremoved from public API in version 16 (ICS MR2) 
//should maintain as a hidden API for binary compatibility for a little longer 
Log.w(TAG, "WARNING: NfcAdapter.getDefaultAdapter() is deprecated, use " + 
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"NfcAdapter.getDefaultAdapter(Context) instead", new Exception()); 


return NfcAdapter.getNfcAdapter(null); 


} 
public boolean isEnabled() { 
try { 
return sService.getState() == STATE_ON; 
} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 
} 
} 
public int getAdapterState() { 
try { 


return sService.getState(); 

} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return NfcAdapter.STATE_OFF; 

} 


public boolean enable() { 
try { 
return sService.enable(); 
} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 


} 


public boolean disable() { 
try { 
return sService.disable(true); 
} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 
return false; 


} 


public void setBeamPushUris(Uri[] uris, Activity activity) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
if (uris != null) { 
for (Uri uri : uris) { 
if (uri == null) throw new NullPointerException("Uri not " + 
"allowed to be null"); 
String scheme - uri.getScheme(); 
if (scheme == null || (Ischeme.equalslgnoreCase("file") && 
Ischeme.equalslgnoreCase("content"))) { 
throw new IllegalArgumentException("URI needs to have " + 
"either scheme file or scheme content"); 
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} 
} 
mNfcActivityManager.setNdefPushContentUri(activity, uris); 
} 
public void setBeamPushUrisCallback(CreateBeamUrisCallback callback, Activity activity) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushContentUriCallback(activity, callback); 
} 
public void setNdefPushMessage(NdefMessage message, Activity activity, 
Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 


} 
mNfcActivityManager.setNdefPushMessage(activity, message, 0); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 


} 
mNfcActivityManager.setNdefPushMessage(a, message, 0); 


} 
} catch (IllegalStateException e) { 
if (targetSdkVersion < android.os.Build. VERSION CODES.JELLY BEAN)( 
Log.e(TAG, "Cannot call API with Activity that has already " * 
"been destroyed", e); 
) else ( 
throw(e); 


} 
} 


p 
* @hide 
4 
public void setNdefPushMessage(NdefMessage message, Activity activity, int flags) ( 
if (activity == null) ( 
throw new NullPointerException("activity cannot be null"); 
} 
mNfcActivityManager.setNdefPushMessage(activity, message, flags); 
} 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 
ji 
mNfcActivityManager.setNdefPushMessageCallback(activity, callback, 0); 
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for (Activity а : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 
} 
mNfcActivityManager.setNdefPushMessageCallback(a, callback, 0); 
} 
} catch (IllegalStateException е) { 
if (targetSdkVersion < android.os.Build. VERSION_CODES.JELLY_BEAN) { 
Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 
}еіѕе { 
throw(e); 
} 
} 


} 
public void setNdefPushMessageCallback(CreateNdefMessageCallback callback, Activity activity, 
int flags) { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 


} 
mNfcActivityManager.setNdefPushMessageCallback(activity, callback, flags); 


} 
public void setOnNdefPushCompleteCallback(OnNdefPushCompleteCallback callback, 
Activity activity, Activity ... activities) { 
int targetSdkVersion = getSdkVersion(); 
try { 
if (activity == null) { 
throw new NullPointerException("activity cannot be null"); 


} 
mNfcActivityManager.setOnNdefPushCompleteCallback(activity, callback); 
for (Activity a : activities) { 
if (a == null) { 
throw new NullPointerException("activities cannot contain null"); 


} 
mNfcActivityManager.setOnNdefPushCompleteCallback(a, callback); 


} 
} catch (IllegalStateException e) { 
if (targetSdkVersion < android.os.Build. VERSION CODES.JELLY BEAN)( 
Log.e(TAG, "Cannot call API with Activity that has already " + 
"been destroyed", e); 
) else( 
throw(e); 
) 
) 
) 
public void enableForegroundDispatch(Activity activity, PendingIntent intent, 
IntentFilter[] filters, String[][] techLists) ( 
if (activity == null || intent == null) { 
throw new NullPointerException(); 
} 
if (lactivity isResumed()) { 
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throw new IllegalStateException("Foreground dispatch can only be enabled "+ 
“when your activity is resumed"); 
} 
try { 
TechListParcel parcel = null; 
if (techLists != null && techLists.length > 0) { 
parcel = new TechListParcel(techLists); 
} 
ActivityThread.currentActivityThread().registerOnActivityPausedListener(activity, 
mForegroundDispatchListener); 
sService.setForegroundDispatch(intent, filters, parcel); 
} catch (RemoteException e) { 
attemptDeadServiceRecovery(e); 


} 


} 
public void disableForegroundDispatch(Activity activity) { 
ActivityThread.currentActivityThread().unregisterOnActivityPausedListener(activity, 
mForegroundDispatchListener); 
disableForegroundDispatchinternal(activity, false); 
} 
(3) NdefMessage 和 NdefRecord 
NDEF 是 NFC 论坛 定义 的 数据 结构 ， 用 来 将 有 效 的 数据 存储 到 NFC tags H, ШП ЖЖ, URL 和 其 
他 MIME 类 型 。 一 个 NdefMessage 扮演 一 个 容器 ， 这 个 容器 存储 那些 发 送 和 读 到 的 数据 。 一 个 
NdefMessage 对 象 包含 0 或 多 个 NdefRecord， 每 个 NDEF record 有 一 个 类 型 ， 如 文本 、URL、 智 慧 弄 
海报 /广告 ， 或 其 他 MIME 数据 。 在 NdefMessage 中 的 第 一 个 NfcRecord 的 类 型 ， 功 能 是 发 送 tag 到 一 
个 Android 设备 上 的 Activity 。 其 中 类 NdefMessage 在 文件 /frameworks/base/core/java/android/nfe/ 
NdefMessage.java 中 定义 ， 具 体 实现 代码 如 下 : 
public final class NdefMessage implements Parcelable { 
private final NdefRecord[] mRecords; 
public NdefMessage(byte[] data) throws FormatException { 


if (data == null) throw new NullPointerException("data is null"); 
ByteBuffer buffer = ByteBuffer.wrap(data); 


mRecords = NdefRecord.parse(buffer, false); 


if (buffer.remaining() > 0) { 
throw new FormatException('trailing data"); 
) 


} 
public NdefMessage(NdefRecord record, NdefRecord ... records) { 
if (record == null) throw new NullPointerException("record cannot be null"); 


for (NdefRecord г: records) { 
if (r == null) { 
throw new NullPointerException("record cannot be null"); 
} 
} 


mRecords = new NdefRecord[1 + records.length]; 
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mRecords[0] = гесога; 
System.arraycopy(records, 0, mRecords, 1, records.length); 
} 
public NdefMessage(NdefRecord[] records) { 
if (records.length < 1) { 
throw new IllegalArgumentException("must have at least one record"); 


} 
for (NdefRecord г: records) { 
if (r == null) { 
throw new NullPointerException("records cannot contain null"); 
} 
} 


mRecords = records; 


} 
public NdefRecord[] getRecords() { 
return mRecords; 


} 
public int getByteArrayLength() { 
int length = 0; 
for (NdefRecord г : mRecords) { 
length += r.getByteLength(); 


return length; 


} 
public byte[] toByteArray() { 
int length = getByteArrayLength(); 
ByteBuffer buffer = ByteBuffer.allocate(length); 


for (int i=0; i<mRecords.length; i++) { 
boolean mb = (i == 0); 
boolean me = (i == mRecords.length - 1); 
mRecords[i].writeToByteBuffer(buffer, mb, me); 


} 


return buffer.array(); 


} 


@Override 
public int describeContents() { 
return 0; 


} 


@Override 

public void writeToParcel(Parcel dest, int flags) { 
dest.writeInt(mRecords.length); 
dest.writeTypedArray(mRecords, flags); 

} 


public static final Parcelable.Creator<NdefMessage> CREATOR = 
new Parcelable.Creator<NdefMessage>() { 
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@Override 

public NdefMessage createFromParcel(Parcel in) { 
int recordsLength = in.readint(); 
NdefRecord[] records = new NdefRecord[recordsLength]; 
in.readTypedArray(records, NdefRecord.CREATOR); 
return new NdefMessage(records); 

} 

@Override 

public NdefMessage[] newArray(int size) { 
return new NdefMessage[size]; 

} 

} 


@Override 

public int hashCode() { 
return Arrays.hashCode(mRecords); 

} 

@Override 

public boolean equals(Object obj) { 
if (this == obj) return true; 
if (obj == null) return false; 
if (getClass() != obj.getClass()) return false; 
NdefMessage other = (NdefMessage) obj; 
return Arrays.equals(mRecords, other.mRecords); 


} 


@Override 
public String toString() { 
return "NdefMessage " + Arrays.toString(mRecords); 
} 
} 
(4) Tag 
Ж Tag fE Ж {+/frameworks/base/core/java/android/nfe/Tag.java 中 定义 ,此 类 用 于 标示 一 个 被 动 的 NFC 
目标 ， 如 tag、card 和 钥匙 挂 扣 ， 甚 至 是 一 个 电话 模拟 的 NFC 卡 。 当 一 个 tag 被 检测 到 时 ， 一 个 tag 对 
象 将 被 创建 并 且 封装 到 一 个 Intent 中 , 然后 NFC 发 布 系统 将 这 个 Intent 用 startActivity 发 送 到 注册 了 接 
收 这 种 Intent 的 Activity 中 。 我 们 可 以 用 方法 getTechList0 来 得 到 这 个 tag 支持 的 技术 细节 ， 并 创建 一 
个 android.nfc.tech 提供 的 相应 的 TagTechnology 对 象 。 文 件 Tag.java 的 具体 实现 代码 如 下 : 
public final class Tag implements Parcelable { 
final byte[] mld; 
final int] mTechList; 
final String[] mTechStringList; 
final Bundle[] mTechExtras; 
final int mServiceHandle; 
final INfcTag mTagService; 


int mConnectedTechnology; 
public Tag(byte[] id, int[] techList, Bundle[] techListExtras, int serviceHandle, 


INfcTag tagService) { 
e 


if (techList == null) ( 
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throw new IllegalArgumentException("rawTargets cannot be null"); 
} 
mld = id; 
mTechList = Arrays.copyOf(techList, techList.length); 
mTechStringList = generateTechStringList(techList); 
mTechExtras = Arrays.copyOf(techListExtras, techList.length); 
mServiceHandle = serviceHandle; 
mTagService = tagService; 


mConnectedTechnology = -1; 
} 
public static Tag createMockTag(byte[] id, int[] techList, Bundle[] techListExtras) { 
return new Tag(id, techList, techListExtras, 0, null); 
} 
(5) tech T Hof 
除 此 之 外 , 在 frameworks/base/core/java/android/nfc/tech/ H 3 rh € 7 Fi) tag 属性 和 进行 IO 操作 


的 类 。 这 些 类 分 别 标示 一 个 tag 支持 的 不 同 的 МЕС 技术 标准 ， 如 图 16-1 所 示 。 


UI Oa ET ES Га а [2] 
E- MR mete = + ШӨ 

jose | eem | ser [se | | 

BasicTagTechnology. java. 2013/8/14 9:20 JAVA 文件 sm 

IsoDep. java. 2013/8/14 9:20 JAVA 文件 sm 

MifareClassic. java 2013/8/14 9:20 JAVA 文件 24 в 

Mi farelltralight. java 2013/8/14 9:20 JAVA 文件 us 

Ndef java 2013/8/14 9:20 JAVA 文件 15 в 

NdefFormatable, java 2013/8/14 9:20 JAVA 文件 тю 

NECA. java 2013/8/14 9:20 JAVA 文件 6 кв 

NEcB java 2013/8/14 9:20 JAVA 文件 5» 

NfcBarcode. java 2013/8/14 9:20 JAVA 文件 se 

ECF. java 2013/8/14 9:20 JAVA 文件 sn 

NfeV. java 2013/8/14 9:20 JAVA 文件 sp 

E) package. html 2013/8/14 9:20 ктш. 文档 i 

TagTechnology java 2013/8/14 9:20 JAVA 文件 9m 


图 16-1 frameworks/base/core/java/android/nfc/tech/ Н Ж 
在 图 16-1 所 示 的 目录 中 ， 接 口 TagTechnology ЖЖ 16-2 中 所 有 Tag Technology 类 必须 实现 的 。 
Ж 16-2 必须 实现 的 Tag Technology 类 


NfcA 支持 ISO 14443-3A 标准 的 操作 

NfcB 支持 ISO 14443-3B 标准 的 操作 

МИСЕ 支持 JIS 6319-4 标准 的 操作 

NfcV 支持 ISO 15693 标准 的 操作 

IsoDe 支持 ISO 14443-4 标准 的 操作 

Ndef 提供 对 那些 被 格式 化 为 NDEF 的 tag 的 数据 的 访问 和 其 他 操作 

NdefFormatable 对 那些 可 以 被 格式 化 为 NDEF 的 tag 提供 一 个 格式 化 的 操作 

MifareClassic 如 果 android 设备 支持 MIFARE， 提 供 对 MIFARE Classic 目标 的 属性 和 LO 操作 
MifareUltralight 如 果 android 设备 支持 MIFARE， 提 供 对 MIFARE Ultralight 目标 的 属性 和 LO 操作 


而 类 NdefFormatable 对 那些 可 以 被 格式 化 成 NDEF 格式 的 tag 提供 一 个 格式 化 的 操作 ， 文 件 
frameworks/base/core/java/android/nfc/tech/NdefFormatable.java 的 具体 实现 代码 如 下 : 
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public final class NdefFormatable extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
public static NdefFormatable get(Tag tag) { 
if (Itag.hasTech(TagTechnology.NDEF FORMATABLE)) return null; 
try { 
return new NdefFormatable(tag); 
} catch (RemoteException e) { 
return null; 
] 
} 
/*package*/ void format(NdefMessage firstMessage, boolean makeReadOnly) throws IOException, 
FormatException { 
checkConnected(); 


try { 
int serviceHandle = mTag.getServiceHandle(); 
INfcTag tagService = mTag.getTagService(); 
int errorCode = tagService.formatNdef(serviceHandle, MifareClassic.KEY_DEFAULT); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR 10: 
throw new IOException(); 
case ErrorCodes.ERROR_INVALID_PARAM: 
throw new FormatException(); 
default: 
throw new IOException(); 


} 
if (!tagService.isNdef(serviceHandle)) { 
throw new IOException(); 


} 


if (firstMessage != null) { 
errorCode = tagService.ndefWrite(serviceHandle, firstMessage); 
switch (errorCode) { 
case ErrorCodes.SUCCESS: 
break; 
case ErrorCodes.ERROR IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new FormatException(); 
default: 
throw new IOException(); 


) 
) 
if (makeReadOnly) ( 
errorCode - tagService.ndefMakeReadOnly(serviceHandle); 
switch (errorCode) ( 
case ErrorCodes. SUCCESS: 
break; 
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case ErrorCodes.ERROR_IO: 
throw new IOException(); 
case ErrorCodes.ERROR INVALID PARAM: 
throw new IOException(); 
default: 
throw new IOException(); 
) 
) 
} catch (RemoteException e) ( 
Log.e(TAG, "NFC service dead", e); 
} 
} 

} 

类 MifareClassic 在 文件 frameworks/base/core/java/android/nfc/tech/MifareClassic.java 中 定义 ， 如 果 
Android 设备 支持 MIFARE， 则 提供 对 MIFARE Classic 目标 的 属性 和 IO 操作 。 文 件 MifareClassic.java 
的 具体 实现 代码 如 下 : 

public final class MifareClassic extends BasicTagTechnology { 

private static final String TAG = "NFC"; 
public static final byte] KEY DEFAULT = 
{(byte)OxFF, (byte)OxFF, (byte)OxFF, (byte)OxFF, (byte)OxFF, (byte )OxFF}; 
public static final byte[] KEY_MIFARE_APPLICATION_DIRECTORY = 
{(byte)0xA0, (byte)0xA1 ,(byte)0xA2, (byte)0xA3,(byte)0xA4,(byte)0xA5}; 
public static final byte] KEY МЕС FORUM = 
((byte)OxD3, (byte )OxF7, (byte)0xD3, (byte)0xF7, (byte)0xD3,(byte)0xF7}; 


/** A MIFARE Classic compatible card of unknown type */ 
public static final int TYPE UNKNOWN = -1; 

/** A MIFARE Classic tag */ 

public static final int TYPE CLASSIC = 0; 

/** A MIFARE Plus tag */ 

public static final int TYPE PLUS = 1; 

/** А MIFARE Pro tag */ 

public static final int TYPE PRO = 2; 


/** Tag contains 16 sectors, each with 4 blocks */ 
public static final int SIZE 1K = 1024; 
/** Tag contains 32 sectors, each with 4 blocks */ 
public static final int SIZE 2K = 2048; 
p 

* Tag contains 40 sectors. The first 32 sectors contain 4 blocks and the last 8 sectors 

* contain 16 blocks 

* 

] 

public static final int SIZE 4K = 4096; 
/** Tag contains 5 sectors, each with 4 blocks */ 
public static final int SIZE MINI = 320; 


/** Size of a MIFARE Classic block (in bytes) */ 
public static final int BLOCK SIZE = 16; 


private static final int MAX BLOCK COUNT - 256; 
private static final int MAX SECTOR. COUNT = 40; 
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private boolean mlsEmulated; 
private int mType; 
private int mSize; 
public static MifareClassic get(Tag tag) { 
if (Itag.hasTech(TagTechnology.MIFARE. CLASSIC)) return null; 
try { 
return new MifareClassic(tag); 
} catch (RemoteException e) { 
return null; 
} 
} 
I* @hide */ 
public MifareClassic(Tag tag) throws RemoteException ( 
super(tag, TagTechnology.MIFARE CLASSIC); 
МСА a = NfcA.get(tag); //MIFARE Classic is always based on МЕС a 
mlsEmulated = false; 
Switch (a.getSak()) { 
case 0x01: 
case 0x08: 
mType = TYPE CLASSIC; 
mSize = SIZE 1K; 
break; 
case 0x09: 
mType = TYPE CLASSIC; 
mSize = SIZE MINI; 


break; 

case 0x10: 
mType = TYPE PLUS; 
mSize = SIZE 2K; 
IISecLevel = SL2 
break; 

case 0x11: 
mType = TYPE PLUS; 
mSize - SIZE 4K; 
//Seclevel = 512 
break; 

case 0x18: 


mType = TYPE_CLASSIC; 
mSize = SIZE 4K; 
break; 

case 0x28: 
mType = TYPE_CLASSIC; 
mSize = SIZE_1K; 
mlsEmulated = true; 
break; 

case 0x38: 
mType = TYPE_CLASSIC; 
mSize = SIZE 4K; 
mlsEmulated = true; 
break; 
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case 0x88: 
mType = TYPE_CLASSIC; 
mSize = SIZE_1K; 
IINXP-tag: false 
break; 
case 0x98: 
case 0xB8: 
mType = TYPE PRO; 
mSize - SIZE 4K; 
break; 
default: 
throw new RuntimeException( 
"Tag incorrectly enumerated as MIFARE Classic, SAK = " + a.getSak()); 
} 
} 
类 MifareUltralight 在 文件 frameworks/base/core/java/android/nfc/tech/MifareUltralight java 中 定义 ， 
如 果 Android 设备 支持 MIFARE， 则 提供 对 MIFARE Ultralight 目标 的 属性 和 UO 操作 。 
public final class MifareUltralight extends BasicTagTechnology { 
private static final String TAG = "NFC"; 
/** AMIFARE Ultralight compatible tag of unknown type */ 
public static final int TYPE_UNKNOWN = -1; 
/** A MIFARE Ultralight tag */ 
public static final int TYPE_ULTRALIGHT = 1; 
/** A MIFARE Ultralight C tag */ 
public static final int ТҮРЕ ULTRALIGHT C = 2; 
/** Size of a MIFARE Ultralight page in bytes */ 
public static final int PAGE SIZE = 4; 
private static final int МХР MANUFACTURER 10 = 0x04; 
private static final int MAX PAGE COUNT - 256; 
I** @hide */ 
public static final Sting EXTRA IS UL C - "isulc"; 
private int mType; 
public static MifareUltralight get(Tag tag) { 
if (Itag.hasTech(TagTechnology.MIFARE ULTRALIGHT)) return null; 
try { 
return new MifareUltralight(tag); 
} catch (RemoteException e) { 
return null; 
} 
} 
/** @hide */ 
public MifareUltralight(Tag tag) throws RemoteException { 
super(tag, TagTechnology.MIFARE_ULTRALIGHT); 
NfcA a = NfcA.get(tag); 
mType = TYPE_UNKNOWN; 
if (a.getSak() == 0x00 88 tag.getld()[0] == NXP_MANUFACTURER ID) { 
Bundle extras = tag.getTechExtras(Tag Technology. MIFARE_ULTRALIGHT); 
if (extras.getBoolean(EXTRA_IS_UL_C)) { 
mType = TYPE ULTRALIGHT C; 
) else ( 
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mType = TYPE. ULTRALIGHT; 


} 

} 

public byte[] readPages(int pageOffset) throws IOException { 
validatePagelndex(pageOffset); 
checkConnected(); 


byte[] cmd = ( 0x30, (byte) pageOffset}; 
return transceive(cmd, false); 

} 

public void writePage(int pageOffset, byte[] data) throws IOException { 
validatePageIndex(pageOffset); 
checkConnected(); 
byte[] cmd = new byte[data.length + 2]; 
cmd[0] = (byte) 0xA2; 
cmd[1] = (byte) pageOffset; 
System.arraycopy(data, 0, cmd, 2, data.length); 
transceive(cmd, false); 


public void setTimeout(int timeout) { 


try { 
int err = mTag.getTagService().setTimeout( 
TagTechnology.MIFARE_ULTRALIGHT, timeout); 
if (err != Errorcodes.SUCCESS) { 
throw new IllegalArgumentException("The supplied timeout is not valid"); 


} catch (RemoteException e) { 
Log.e(TAG, "МЕС service dead", е); 
} 


public int getTimeout() { 


try { 

return mTag.getTagService().getTimeout(Tag Technology. MIFARE_ULTRALIGHT); 
} catch (RemoteException e) { 

Log.e(TAG, "МЕС service dead", е); 

return 0; 


} 


private static void validatePagelndex(int pagelndex) { 
if (pagelndex < 0 || pagelndex >= MAX_PAGE_COUNT) { 
throw new IndexOutOfBoundsException("page out of bounds: " + pagelndex); 


} 
} 


16.3.2 分析 JNI 部 分 


在 Android 系统 中 ，NFC 模块 的 INI 部 分 代码 通过 目录 /packages/apps/Nfc/nxp/jni 实现 。 
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INI 部 分 代码 向 上 会 和 Framework 层 的 Java 代码 进行 交互 ， 向 下 会 和 libnfe 层 进行 交互 。JNI 层 的 
核心 文件 是 com_android_nfe NativeNfcManagercpp, 功能 是 初始 化 并 启动 NFC 服务 , 并 扫描 和 读 取 tag。 
文件 com android пёс NativeNfcManagercpp 的 主要 实现 代码 如 下 : 

static void client_kill_deferred_call(void* arg) 


{ 


struct nfc_jni_native_data *nat = (struct nfc_jni_native_data *)arg; 


nat->running = FALSE; 
} 


static void kill_client(nfc_jni_native_data *nat) 
{ 
phDal4Nfc_Message_Wrapper_t wrapper; 
phLibNfc DeferredCall t *pMsg; 


usleep(50000); 
ALOGD("Terminating client thread..."); 


pMsg = (phLibNfc_DeferredCall_t*)malloc(sizeof(phLibNfc_DeferredCall_t)); 
pMsg->pCallback = client_kill_deferred_call; 
pMsg->pParameter = (void*)nat; 


wrapper.msg.eMsgType = PH_LIBNFC_DEFERREDCALL_MSG; 
wrapper.msg.pMsgData = pMsg; 
wrapper.msg.Size = sizeof(phLibNfc_DeferredCall_t); 


phDal4Nfc msgsnd(gDrvCfg.nClientld, (struct msgbuf *)&wrapper, sizeof(phLibNfc_Message_t), 0); 
} 


static void nfc_jni_ioctl_callback(void *pContext, phNfc_sData_t *pOutput, NFCSTATUS status) { 
struct nfc_jni_callback_data * pCallbackData = (struct nfc_jni_callback_data *) pContext; 
LOG_CALLBACK("nfc_jni_ioctl_callback", status); 


/* Report the callback status and wake up the caller */ 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 

} 


static void nfc_jni_deinit_download_callback(void *pContext, NFCSTATUS status) 


{ 
struct nfc_jni_callback_data * pCallbackData = (struct nfc_jni_callback_data *) pContext; 
LOG_CALLBACK("nfc_jni_deinit_download_callback", status); 


/* Report the callback status and wake up the caller */ 
pCallbackData->status = status; 
sem_post(&pCallbackData->sem); 

} 


static int nfc jni download locked(struct nfc jni native data *nat, uint8 t update) 


{ 
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uint8 t OutputBuffer[1]; 

uint8 t InputBuffer[1]; 

struct timespec ts; 

NFCSTATUS status - NFCSTATUS FAILED; 
phLibNfc StackCapabilities t caps; 

struct nfc jni callback data cb data; 

bool result; 


/* Create the local semaphore */ 
if (Infc cb data init(&cb data, NULL)) 
{ 


goto clean_and_return; 


} 
if(update) 


TRACE("phLibNfc Mgt Delnitialize() (download)"); 

REENTRANCE LOCK(); 

status - phLibNfc Mgt Delnitialize(gHWRef, nfc jni deinit download callback, (void *)&cb data); 
REENTRANCE UNLOCK(); 

if (status = NFCSTATUS PENDING) 


ALOGE("phLibNfc_Mgt_Delnitialize() (download) returned 0x%04x[%s]", status, nfc_jni_get_status_ 
name(status)); 


clock_gettime(CLOCK_REALTIME, &ts); 
ts.tv_sec += 5; 


/* Wait for callback response */ 
if(sem timedwait(&cb data.sem, &ts)) 


ALOGW('Deinitialization timed out (download)"); 
) 


if(cb_data.status I= NFCSTATUS SUCCESS) 


ALOGW('Deinitialization FAILED (download)"); 


) 
TRACE("Deinitialization SUCCESS (download)"); 


) 
result = performDownload(nat, false); 


if (Iresult) { 
status = NFCSTATUS_FAILED; 
goto clean_and_return; 


} 


TRACE("phLibNfc_Mgt_Initialize()"); 

REENTRANCE LOCK(); 

status = phLibNfc Mgt Initialize(gHWRef, nfc jni init callback, (void *)&cb data); 
REENTRANCE. UNLOCK(); 
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if(status != NFCSTATUS_PENDING) 


{ 
ALOGE("phLibNfc_Mgt_Initialize() (download) returned 0x%04x[%s]", status, nfc jni get status name 
(status)); 
goto clean_and_return; 
} 


TRACE("phLibNfc_Mgt_Initialize() returned 0x%04x[%s]", status, nfc_jni_get_status_name(status)); 


if(sem_wait(&cb_data.sem)) 

{ 
ALOGE("Failed to wait for semaphore (errno=0x%08x)", errno); 
status = NFCSTATUS_FAILED; 
goto clean_and_return; 


} 


/* Initialization Status */ 
if(cb data.status = NFCSTATUS SUCCESS) 


status = cb data.status; 
goto clean and return; 


/* ====== CAPABILITIES ======= * 

REENTRANCE_LOCK(); 

status = phLibNfc_Mgt_GetstackCapabilities(&caps, (void*)nat); 
REENTRANCE_UNLOCK(); 

if (status != NFCSTATUS SUCCESS) 


ALOGW("phLibNfc Mgt GetstackCapabilities returned 0x%04x[%s]", status, nfc_jni_get_status_ name 
(status)); 
} 


else 


ALOGD("NFC capabilities: HAL = %x, FW = 96x, HW = %x, Model = %x, НСІ = %x, Full FW = %d, Rev 

= %d, FW Update Info = %d", 

caps.psDevCapabilities.hal_version, 

caps.psDevCapabilities.fw_version, 

caps.psDevCapabilities.hw_version, 

caps.psDevCapabilities.model_id, 

caps.psDevCapabilities.hci_version, 

caps.psDevCapabilities.full version|]NXP FULL VERSION, LEN-1], 

caps.psDevCapabilities.full version|]NXP FULL VERSION LEN-2], 

caps.psDevCapabilities.firmware update info); 


} 


/*Download is successful*/ 
status - NFCSTATUS SUCCESS; 


clean and return: 
nfc cb data deinit(&cb data); 
return status; 


) 
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static int nfc_jni_configure_driver(struct nfc_jni_native_data *nat) 


{ 
char value[PROPERTY_VALUE_MAX]; 
int result = FALSE; 
NFCSTATUS status; 
== CONFIGURE DRIVER ======= * 
/* Configure hardware link */ 
gDrvCfg.nClientld = phDal4Nfc_msgget(0, 0600); 
TRACE("phLibNfc_Mgt_ConfigureDriver(0x%08x)", gDrvCfg.nClientld); 
REENTRANCE LOCK(); 
status = phLibNfc Mgt ConfigureDriver(&gDrvCfg, &gHWRef); 
REENTRANCE UNLOCK(); 
if(status == NFCSTATUS ALREADY INITIALISED) ( 
ALOGW("phLibNfc Mgt ConfigureDriver() returned 0x%04x[%s]", status, nfc jni get status name 
(status)); 


} 
else if(status = NFCSTATUS SUCCESS) 
ALOGE("phLibNfc_Mgt_ConfigureDriver() returned 0x%04x[%s]", status, nfc_jni_get_status_name 
(status)); 
goto clean_and_return; 
TRACE("phLibNfc_Mgt_ConfigureDriver() returned 0x%04x[%s]", status, nfc_jni_get_status_name(status)); 
if(pthread_create(&(nat->thread), NULL, nfc_jni_client_thread, nat) != 0) 
ALOGE("pthread_create failed"); 


goto clean_and_return; 


} 
driverConfigured = TRUE; 


clean_and_return: 


return result; 
} 
static int nfc_jni_unconfigure_driver(struct nfc_jni_native_data *паї) 
{ 


int result = FALSE; 
NFCSTATUS status; 


/* Unconfigure driver */ 
TRACE("phLibNfc_Mgt_UnConfigureDriver()"); 
REENTRANCE_LOCK(); 

status = phLibNfc_Mgt_UnConfigureDriver(gHWRef); 
REENTRANCE_UNLOCK(); 

if(status =| NFCSTATUS SUCCESS) 


ALOGE("phLibNfc_Mgt_UnConfigureDriver() returned error 0х%04х[%5] -- this should never happen", 
status, nfc jni get status name( status)); 
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else 


ALOGD("phLibNfc_Mgt_UnConfigureDriver() returned 0x%04x[%s]", status, nfc_jni_get_status_name 
(status)); 
result = TRUE; 
} 


driverConfigured = FALSE; 


return result; 


} 
16.3.3 DRE 


在 Android 系统 中 ，NFC 模块 的 底层 部 分 有 驱动 部 分 和 libnfe 库 部 分 两 大 类 。 驱 动 部 分 在 device 
目录 中 实现 ， 例 如 device/samsung/tuna/nfe 目录 中 保存 了 设备 厂家 三 星 电子 提供 的 hardware lib. ii 
libnfc-nci 和 libnfe-nxp 目录 中 的 底层 文件 则 负责 NFC 数据 的 读 取 和 解析 工作 。 


164 £ Android 系统 编写 NFC APP 的 方法 


н 知识 点 讲解 光盘 :视频 \ 知 识 点 \ 第 16 章 \ 在 Android 系统 编写 NFC APP 的 方法 .avi 

当 Android 手机 开启 了 NFC 程序 ， 并 且 检 测 到 一 个 TAG Ja, TAG 分 发 系统 会 自动 创建 一 个 封装 
了 NFC TAG 信息 的 Intent。 如 果 多 于 一 个 应 用 程序 能 够 处 理 这 个 Intent， 那 么 手机 就 会 弹出 一 个 对 话 
框 ， 让 用 户 选择 处 理 该 TAG 的 Activity, fE TAG 分 发 系统 中 定义 了 3 种 Intent， 按 优先 级 从 高 到 低 排 
列 顺序 依次 是 NDEF DISCOVERED、TECH DISCOVERED fil TAG DISCOVERED. 

当 Android 设备 检测 到 有 NFC Tag 靠近 时 ,会 根据 Action 声明 的 顺序 给 对 应 的 Activity 发 送 含 NFC 
消息 的 Intent。 此 处 使 用 的 intent-filter 的 Action 类 型 为 TECH DISCOVERED， 从 而 可 以 处 理 所 有 类 
型 为 ACTION_TECH DISCOVERED 并 且 使 用 的 技术 为 nfe_tech_filterxml 文件 中 定义 的 类 型 的 ТАС. 

当 Android 手机 检测 到 一 个 TAG 时 ， 启 用 Activity 的 匹配 过 程 如 图 16-2 所 示 。 


u 
| NDEF Formatted Tag — > NDEF DISCOVERED -一 > ‘handle |— ves 


( 
or Non- | | Lo ve intent delivered to. | 
| NOEP онын Tog [一 ~ TECH DISCOVERED ——> handle 上 Yes | ы | 


16-2 ”启用 Activity 的 匹配 过 程 


DO Android oe ae ACA [18132 


TE Android 系统 中 ， 编 写 NFC APP 的 基本 流程 如 下 。 

(1) 在 相关 的 androidManifest 文件 中 设置 NFC 权限 ， 具 体 代 码 如 下 : 
<uses-permission android:name="android.permission.NFC" /> 

(2) 设置 SDK 的 级 别 限制 ， 例 如 设置 为 API 10. 


<uses-sdk android:minSdkVersion="10"/> 


(3) 声明 特殊 功能 的 限制 权限 ， 通 过 如 下 声明 可 以 让 应 用 程序 在 Google Play 上 声明 使 用 者 必须 


HA NFC 功能 。 


<uses-feature android:name="android.hardware.nfc" android:required="true" /> 
(4) 实现 NEC 标签 过 滤 。 
在 Activity 的 Intent 过 滤 XML 声明 中 ， 可 以 同时 声明 过 滤 如 下 3 种 action 〈 动 作 )， 但 是 需要 提前 


知道 系统 在 发 送 Intent 时 拥有 的 优先 级 。 


动作 1: 过 滤 ACTION TAG DISCOVERED 
<intent-filter> 
«action android:name="android.nfc.action. TAG_DISCOVERED"/> 
«category android:name="android.intent.category.DEFAULT"/> 
</intent-filter> 


这 个 最 简单 ， 也 是 最 后 一 个 被 尝试 接收 intent 的 选项 。 


М ”动作 2: 过 滤 ACTION NDEF DISCOVERED 
<intent-filter> 
«action android:name="android.nfc.action.NDEF_DISCOVERED"/> 
«category android:name="android.intent.category.DEFAULT"/> 
<data android:mimeType="text/plain" /> 

</intent-filter> 


其 中 最 重要 的 是 дала 的 mimeType 类 型 , 此 定义 越 准 确 , Intent 指向 这 个 Activity 的 成 功率 就 越 高 ， 


— EAS AUT] Ж И] NDEF intent. 


tech : 


动作 3: 过滤 ACTION TECH DISCOVERED 
Ene 要 在 <project-path>/res/xml 下 面 创建 一 个 过 滤 规则 文件 ， 可 以 任意 命名 ， 例 如 可 以 叫做 nfe_ 
filterxml。 这 其 中 定义 的 是 nfc 实现 的 各 种 标准 ， 每 一 个 NFC 卡 都 会 符合 多 个 不 同 的 标准 。 


在 检测 到 МЕС 标签 后 ， 使 用 getTechList0 方 法 来 查看 所 检测 的 tag 究竟 支持 哪些 NEC 标准 。 在 一 

nfc tech filter.xml 文件 中 可 以 定义 多 个 <tech-list> 结 构 组 ， 每 一 组 代表 声明 只 接受 同时 满足 这 些 标准 的 
NEC 标签 。 例如 A 组 表示 ,只 有 同时 满足 IsoDep. NfcA. МВ. МЕСЕ 这 4 个 标准 的 МЕС 标签 的 Intent 
才能 进入 。A 与 B 组 之 间 的 关系 就 是 只 要 满足 其 中 一 个 即 可 。 换 句 话说 ，NFC 标签 技术 满足 A 的 声明 
也 可 以 ， 满 足 B 的 声明 也 可 以 。 
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<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"> 

<tech-list> — 

<tech>android.nfc.tech.lsoDep</tech> <tech>android.nfc.tech.NfcA</tech> <tech>android.nfc.tech.NfcB</tech> 

<tech>android.nfc.tech.NfcF</tech> 

</tech-list> 

<tech-list>- BB 

<tech>android.nfc.tech.NfcV</tech> <tech>android.nfc.tech.Ndef</tech> <tech>android.nfc.tech. NdefFormatable 

</tech> <tech>android.nfc.tech.MifareClassic</tech> <tech>android.nfc.tech. Mifare Ultralight</tech> 
</tech-list> 

</resources> 


在 androidManifest 文件 中 ， 声 明 xml 过 滤 的 举例 代码 如 下 : 
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<activity> 
<intent-filter> 
<action android:name="android.nfc.action.TECH_DISCOVERED"/> 
</intent-filter> 
«meta-data android:name="android.nfc.action. TECH_DISCOVERED" android:resource=" @xml/nfc_tech filter" 
[> 这 个 就 是 用 户 的 资源 文件 名 
</activity> 


(5) 创建 МЕС 标签 的 前 台 分 发 系统 。 
什么 是 NFC 的 前 台 发 布 系统 ? 就 是 说 当 已 经 打开 应 用 时 ， 那 么 通过 这 个 前 台 发 布 系统 的 设置 ， 可 
以 让 已 经 启动 的 Activity 拥有 更 高 的 优先 级 来 依据 在 代码 中 定义 的 标准 来 过 滤 和 处 理 Intent， 而 不 是 让 
其 他 的 声明 了 Intent Filter 的 Activity 来 干扰 ， 甚 至 连 自己 声明 在 文件 androidManifest 中 的 Intent Filter 
都 不 会 来 干扰 。 也 就 是 说 , Foreground Dispatch 的 优先 级 大 于 Intent Filter。 此 时 有 如 下 所 示 的 两 种 情况 。 
М ”第 一 种 情况 : 当 Activity 没有 启动 时 去 扫描 tag， 那 么 系统 中 所 有 的 Intent Filter 都 将 一 起 参与 
第 二 种 情况 : 75 Activity 启动 去 扫描 tag 时， 那么 将 直接 使 用 在 Foreground Dispatch 中 代码 写 
入 的 过 滤 标 准 。 如 果 这 个 标准 没有 命中 任何 Intent, 那么 系统 将 使 用 所 有 Activity 声明 的 Intent 
Filter xml 来 过 滤 。 
例如 在 OnCreate0 中 可 以 添加 如 下 所 示 的 代码 。 
mPendingIntent = PendingIntent.getActivity(this, 0, 
new Intent(this, getClass()).addFlags(Intent.FLAG ACTIVITY SINGLE TOP), 0); 
/做 一 个 Intent Filter 过 滤 action， 这 里 过 滤 的 是 ndef 


IntentFilter ndef = new IntentFilter(NfcAdapterACTION_NDEF_DISCOVERED); 
// 如 果 对 action 的 定义 有 更 高 的 要 求 ， 如 data 的 要 求 ， 可 以 使 用 如 下 的 代码 来 定义 Intent Filter 


II try { 

I ndef.addDataType("*/*"); 

I } catch (MalformedMimeTypeException e) { 
I I[TODO Auto-generated catch block 

II e.printStackTrace(); 


} 
ИЧЕ pk Intent Filter 
mFilters = new IntentFilter[] ( 
ndef, 


y 
/做 一 个 tech-list。 可 以 看 到 是 二 维 数据 ， 每 一 个 一 维 数组 之 间 的 关系 是 或 ， 但 是 一 个 一 维 数组 之 内 的 各 
个 项 是 与 的 关系 
mTechLists = new String[][] { 
new String[] ( NfcF.class.getName()}, 
new String[]{NfcA.class.getName()}, 
new String[]{NfcB.class.getName()}, 
new String[JNfcV.class.getName()) 
E 
在 onPause0 和 onResume() 中 需要 加 入 如 下 相应 的 代码 。 
public void onPause() { 
super.onPause(); 
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JIRA mAdapter.disableForegroundDispatch(this); 
} 
public void onResume() { 

super.onResume(); 


// 设 定 Intent Filter 和 tech-list。 如 果 两 个 都 为 null， 就 代表 优先 接受 任何 形式 的 TAG action。 也 就 是 说 系统 会 主动 
发 TAG intent 


mAdapter.enableForegroundDispatch(this, mPendinglntent, mFilters, mTechLists); 
} 


16.5 ”实战 演练 一 一 使 用 МЕС 发 送 消息 


Фин 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 16 章 \ 使 用 NFC 发 送 消息 .avi 
当 Android 设备 检测 到 有 NFC Tag 时 ， 预 期 的 行为 是 触发 最 合适 的 Activity 来 处 理 检测 到 的 Tag, 

这 是 因为 МЕС 通常 是 在 非常 近 的 距离 才 起 作用 (<4m)。 如 果 在 此 时 需要 用 户 来 选择 合适 的 应 用 来 处 

理 Tag， 则 很 容易 断 开 与 Tag 之 间 的 通信 ， 因 此 需要 选择 合适 的 Intent Filter 只 处 理 读 写 的 Tag 类 型 。 

Android 系统 支持 两 种 NFC 消息 发 送 机 制 ， 分 别 是 Intent 发 送 机 制 和 前 台 Activity 消息 发 送 机 制 。 

Intent 发 送 机 制 : 当 系 统 检测 到 Tag 时 , Android 系统 提供 manifest 中 

定义 的 Intent Filter 来 选择 合适 的 Activity 来 处 理 对 应 的 Tag, HAL ШШШ 

个 Activity 可 以 处 理 对 应 的 Tag 类 型 时 ， 则 会 显示 Activity 选择 窗口 P NFC Taginfo 

由 用 户 选择 ， 如 图 16-3 所 示 。 

前 台 Activity 消息 发 送 机 制 : 允许 一 个 在 前 台 运 行 的 Activity 拥有 读 
Ej МЕС Tag 的 优先 权 。 如 果 系 统 Android 检测 到 周围 有 NFC Tag, R. 
前 台 人 允许 这 个 Activity 可 以 处 理 该 种 类 型 的 Tag， 那 么 这 个 Activity — 1623 选择 窗口 

即 可 获取 优先 权 ， 而 不 会 出 现 选择 Activity 的 窗口 。 

上 述 两 种 方法 基本 上 都 是 使 用 Intent Filter 来 指明 Activity 可 以 处 理 的 Tag 类 型 ,一 个 是 使 用 Android 

的 Manifest 来 说 明 ， 一 个 是 通过 代码 来 声明 。 

下 面 将 通过 一 个 具体 实例 的 实现 过 程 ,来 讲解 在 Android 系统 中 使 用 МЕС 消息 发 送 机 制 的 基本 方法 。 


(gj Reading Example 


a 


Ф Tags 


х ø th 能 源码 路 径 
实例 16-1 演示 NFC 消息 发 送 机制 的 基本 用 法 光盘 :daima\16\NFCEX 


本 实例 的 具体 实现 流程 如 下 。 
(1) 在 文件 AndroidManifestxml 中 声明 МЕС 权限 ， 有 具体 实现 代码 如 下 : 
«manifest xmIns:android-"http://schemas.android.com/apk/res/android" 
package-"com.pstreets.nfc" 
android:versionCode="1" 
android:versionName="1.0"> 
<uses-sdk android:minSdkVersion="10" /> 
<uses-permission android:name-"android.permission.NFC" /> 
<uses-feature android:name-"android.hardware.nfc" android:required="true" /> 
<application android:icon="@drawable/icon" android:label="@string/app_name"> 


«activity android:name=".NFCDemoActivity" 
android:label="@string/app_name" 
e 
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android:launchMode="singleTop"> 
<intent-filter> 
«action android:name="android.intent.action. MAIN" /> 
«category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
<intent-filter> 
«action android:name="android.nfc.action.NDEF_DISCOVERED"/> 
«data android:mimeType="text/plain" /> 
</intent-filter> 
<intent-filter 
> 
<action 
android:name="android.nfc.action. TAG_DISCOVERED" 
> 
</action> 
<category 
android:name="android.intent.category.DEFAULT" 
> 
</category> 
</intent-filter> 
<!-- Add a technology filter —> 
<intent-filter> 
«action android:name="android.nfc.action. TECH_DISCOVERED" /> 
</intent-filter> 
<meta-data android:name="android.nfc.action. TECH_DISCOVERED" 
android:resource="@xml/filter_nfc" 
> 
</activity> 
«activity android:name=".MainActivity" 
android:label="@string/app_name"> 
<intent-filter> 
«action android:name="android.intent.action.MAIN" /> 
«category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 
这 样 通过 上 述 声 明代 码 ， 当 Android 检测 到 有 Tag 时 ， 会 显示 Activity 选择 窗口 ， 就 会 显示 图 16-3 
所 示 的 Reading Example 效果 。 
(2) 编写 布局 文件 main.xml， 功 能 是 通过 文本 控件 显示 当前 的 扫描 状态 ， 具 体 实现 代码 如 下 : 
<RelativeLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:text="@string/title"> 
<TableLayout 
android:id="@+id/purchScanTable1" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
«TableRow 
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android:id="@+id/table1 Row1" 
android:layout, width-"wrap content" 
android:layout height-"wrap content" 
«TextView 
android:id="@+id/status_label" 
android:layout width-"wrap content" 
android:layout height-"wrap. content" 
android:text="Current Status: "/> 
«TextView 
android:id="@+id/status_data" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-" Scan a Tag" /> 
</TableRow> 
<View 
android:id="@+id/purchScanES1" 
android:layout_width="match_parent" 
android:layout_height="55px" 
android:layout_below="@id/status_label" 
android:background="#000000" /> 
<TableRow 
android:id="@+id/table1 Row2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
<TextView 
android:id="@+id/block_0_label" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:text-"BLOCK 0: "/> 
<TextView 
android:id="@+id/block_0_data" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:text-" " /> 
</TableRow> 
<TableRow 
android:id="@+id/table1 Row3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
<TextView 
android:id="@+id/block_1_label" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text="BLOCK 1: "/> 
<TextView 
android:id="@+id/block_1_data" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-" " /> 
</TableRow> 
</TableLayout> 
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<View 
android:id="@+id/purchScanES 1" 
android:layout_width="match_parent" 
android:layout_height="75px" 
android:layout_below="@id/purchScanTable1" 
android:background="#000000" /> 
<Button 
android:id="@+id/clear_but" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout_below="@id/purchScanES1" 
android:gravity="center_horizontal" 
android:text="Clear" /> 
</RelativeLayout> 
(3) 编写 程序 文件 NFCDemoActiviyjava， 当 在 前 台 运 行 NFCDemoActivity Ff, MRA BRAG 
来 处 理 Mifare 类 型 的 Tag， 此 时 可 以 使 用 前 台 消 息 发 送 机 制 。 文 件 NFCDemoActivity.java 的 具体 实现 
代码 如 下 : 
public class NFCDemoActivity extends Activity { 
private NfcAdapter mAdapter; 
private PendingIntent mPendinglntent; 
private IntentFilter[] mFilters; 
private String[][] mTechLists; 
private TextView mText; 
private int mCount 7 0; 


@Override 
public void onCreate(Bundle savedState) { 
super.onCreate(savedState); 


setContentView(R.layout.foreground_dispatch); 
mText = (TextView) findViewByld(R.id.text); 
mText.setText("Scan a tag"); 


mAdapter = NfcAdapter.getDefaultAdapter(this); 


mPendinglntent = PendinglIntent.getActivity(this, 0, 
new Intent(this, getClass()).addFlags(Intent.FLAG ACTIVITY SINGLE TOP), 0); 


IntentFilter ndef = new IntentFilter(NfcAdapter ACTION TECH DISCOVERED); 
try { 

ndef.addDataType("*/*"); 
} catch (MalformedMimeTypeException e) { 

throw new RuntimeException("fail", е); 


} 

mFilters = new IntentFilter[] { 
ndef, 

k 


mTechLists = new String[][] { new String[] ( MifareClassic.class.getName() ) }; 
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@Override 
public void onResume() { 
super.onResume(); 
mAdapter.enableForegroundDispatch(this, mPendinglIntent, mFilters, mTechLists); 


} 


@Override 

public void onNewintent(Intent intent) { 
Log.i("Foreground dispatch", "Discovered tag with intent: " + intent); 
mText.setText("Discovered tag " + ++mCount + " with intent: " + intent); 


} 
@Override 
public void onPause() { 
super.onPause(); 
mAdapter.disableForegroundDispatch(this); 
} 
} 
这 样 在 执行 本 实例 后 ， 每 当 靠近 一 次 Tag， 计 数 就 会 增加 1。 执 行 效果 如 图 16-4 所 示 。 


图 16-4 执行 效果 
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Google Now 是 谷歌 在 VO 开发 者 大 会 上 随 安 卓 41 系统 同时 推出 的 一 款 应 用 ， 它 会 全 面 了 解 用 户 
的 各 种 习惯 和 正在 进行 的 动作 ,并 利用 它 所 了 解 的 来 为 用 户 提供 相关 信息 。 本 章 将 详细 讲解 在 Android 
设备 中 使 用 Google Now 技术 的 基本 知识 ， 为 步 入 本 书后 面 知 识 的 学 习 打下 基础 。 


17.1 Google Now 介绍 


Фи 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 17 ¥\Google Now 介绍 .avi 

Google Now 是 Google 在 移动 市 场 最 重要 的 创新 之 一 。 通 过 对 用 户 数据 的 挖掘 ，Google Now TEX 
当 的 时 刻 提 供 适 当 的 信息 ， 而 它 的 卡片 式 推送 也 代表 了 Google 展现 信息 的 新 方向 。 正 如 GigaOM 的 作 
者 在 某 次 旅行 中 体会 到 的 ，Google Now 成 了 一 个 有 力 的 帮手 。 虽 然 它 仍 有 些 让 人 不 安 , 但 Google Now 
利 大 于 次 。 本 节 将 详细 讲解 Google Now 的 基本 知识 ， 为 读者 步 入 本 书后 面 知 识 的 学 习 打 下 基础 。 


17.1.1 ”搜索 引擎 的 升级 一 一 Google Now 


Google Now 功能 是 IO 大 会 上 的 一 个 亮点 ， 这 个 可 以 根据 不 同 使 用 习惯 来 帮助 用 户 进 行 多 项 信息 
的 预测 ， 虽 然 人 机 交互 方面 与 1OS 上 的 Siri 还 有 很 大 差距 ， 但 其 预测 比 起 Siri 更 加 实用 。 国 外 媒体 都 
给 了 Google Now 功能 很 高 的 评价 ， 不 过 这 个 功能 在 中 国 受到 很 大 的 限制 。 

在 过 去 的 10 年 中 ,搜索 引擎 的 核心 是 获取 足够 多 的 海量 信息 ,搜索 技术 的 发 展 过 程 是 追赶 如 何 更 
好 地 获取 信息 的 过 程 ， 核 心 是 个 性 化 和 实时 信息 。 但 是 随 着 时 代 的 进步 和 发 展 ， 现 在 搜索 结果 正在 变 
得 越 来 越 个 性 化 。 不 同 的 人 都 会 看 到 他 更 感 兴趣 的 搜索 结果 ， 提 高 了 搜索 的 效率 。 甚 至 由 于 搜索 变 得 
过 于 个 性 化 ， 人 们 获得 的 信息 都 是 自己 想 看 到 的 ， 从 而 让 原本 能 够 扩大 人 们 视野 的 搜索 变 成 了 把 人 们 
限制 在 自我 的 世界 工具 。 这 还 引发 了 关于 搜索 过 分 个 性 化 可 能 引发 的 弊端 的 讨论 。 

搜索 在 个 性 化 方面 的 努力 最 重要 的 是 将 搜索 和 社交 网 络 结合 ， 这 样 搜索 引擎 就 能 获得 用 户 的 更 多 
信息 ， 从 而 更 好 地 帮助 用 户 做 出 判断 。 在 个 性 化 搜索 方面 谷歌 遇 到 了 来 自 Facebook 的 挑战 , 拥有 最 多 
用 户 信息 的 网 站 是 Facebook， 但 它 却 并 不 向 谷歌 开放 。 从 某 种 程度 上 说 ， 谷 歌 推出 自己 的 社交 网 络 
Google+ 的 核心 也 是 希望 获得 更 多 的 用 户 信息 。 

实时 搜索 更 多 是 搜索 在 技术 实现 上 的 改进 ， 当 然 ， 大 部 分 实时 信息 都 存在 于 Twitter 和 雅虎 ， 这 对 
谷歌 也 是 不 小 的 挑战 。 随 着 移动 互联 网 的 发 展 ， 位 置 也 成 为 了 搜索 引擎 提供 结果 的 重要 依据 ， 这 也 是 
个 性 化 的 一 部 分 。 而 随 着 位 置信 息 的 加 入 ， 围 绕 这 一 点 可 以 打造 一 个 生活 服务 的 平台 。 

综 上 所 述 ， 本 地 搜索 将 是 一 个 巨大 的 市 场 ， 这 个 时 候 搜索 提供 的 已 经 不 仅仅 是 信息 ， 更 应 该 是 一 
种 服务 。 正 因 如 此 ，Google Now 便 登 上 了 历史 舞台 ， 接 下 来 看 一 看 Google Now 能 带 来 什么 ? 

E) 新 的 应 用 会 更 加 方便 用 户 收取 电子 邮件 ， 当 接收 到 新 邮件 时 ， 它 就 会 自动 弹出 以 便 查 看 。 
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实现 了 办 理 登 记 手续 的 QR CODE 终端 的 更 新 ， 但 是 这 一 功能 目前 仅 限于 美国 联合 航空 公司 
使 用 。 
具有 新 的 镜头 搜索 功能 ， 令 搜索 和 查找 更 加 方便 准确 。 

具有 步行 和 行车 里 程 记录 功能 ， 这 个 计 步 器 功能 可 通过 Android 设备 的 传感器 来 统计 用 户 每 
月 行驶 的 里 程 ， 包 括 步行 和 骑 自 行车 的 路 程 。 

拥有 并 强化 了 对 博物 馆 、 电 影院 、 餐 厅 等 搜索 帮助 。 

旅游 和 娱乐 特色 功能 : 包括 汽车 租赁 、 演 唱 会 门票 和 通勤 共享 方面 的 卡片 。 公 共 交 通 和 电视 
节目 的 卡片 进行 改善 ， 这 些 卡片 现在 可 以 听 音 识别 音乐 和 节目 信息 。 用 户 可 以 为 新 媒体 节目 
的 开播 设 定 搜索 提醒 ， 同 时 还 可 以 接收 实时 NCAA 橄榄 球 比分 。 


17.1.2 Google Now 的 用 法 


其 实 Google Now 并 不 是 如 同 Google Mail, Google Talk 那样 的 独立 App, Google Now 被 Google 
集成 到 了 Google 搜索 中 。 在 正常 情况 下 ， 开 启 Google 搜索 即 可 使 用 Google Now。 但 是 因为 Google 
搜索 业务 已 经 退出 中 国 大 陆 ， 所 以 Google 也 没 打算 让 Google Now 覆盖 中 国 大 陆 用 户 。 即 使 顺利 安装 
了 Google 搜索 ， 会 依然 找 不 到 Google Now 功能 ， 如 图 17-1 所 示 。 

此 时 需要 经 过 如 下 所 示 的 步骤 进行 设置 。 

(1) 登录 手机 设备 的 Google 账户 。 
(2) 在 “设置 ”选项 中 将 系统 语言 改 为 英文 ， 如 图 17-2 所 示 。 


语音 


中 文 (简体 ) 
手机 搜索 
PX (MI) 
隐私 权 和 帐户 
图 17-1 默认 没有 Google Now 功能 的 Google 搜索 图 17-2 设置 设备 语言 为 英文 


(3) 再 次 开启 Google Search 后 会 发 现 Google Now， 如 图 17-3 所 示 。 
(4) 按照 提示 ， 单 击 Next 按钮 即 可 完成 Google Now 的 初始 化 ,这 时 就 可 以 使 用 Google Now f , 
如 图 17-4 所 示 。 


Google Now 
Ali cards 


Fon 
Notifications Fon 
My stuff 
My sports eam 
Discover Google Now! 
Information when you need it 


Voice 


without searching. Phone search 


Privacy & accounts 
forever. seesee@gmail сот 


17-3 Google Search 中 出 现 Google Now 图 17-4 此 时 可 以 使 用 Google Now 
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(5) 当 设 置 完 Google Now 后 回 到 设置 菜单 , 将 系统 语言 重新 设置 为 简体 中 文 。 设置 完毕 后 , Google 
Now 不 但 不 会 被 关闭 ， 语 言 也 变 成 了 简体 中 文 。 这 意味 着 Google 本 来 就 做 好 了 Google Now 的 简体 中 
文 语言 支持 ， 只 是 没 对 简体 中 文 用 户 开放 而 已 ， 如 图 17-5 所 示 。 

(6) 经 过 测试 后 会 发 现 ， 虽 然 Google Now 没有 针对 国内 用 户 开放 ， 但 是 数据 依然 涵盖 了 国内 。 
在 使 用 期 间 ， 公 交 班 次 、 天 气 等 信息 都 准确 无 误 ， 连 接 也 没 遇 到 什么 阻碍 ， 如 图 17-6 所 示 。 


Language 
ex (att) 
bxc (Iff) 


English 


即时 贴 会 在 您 需要 时 在 


Русский 这 里 显示 


17-5 "P3 Google Now 17-6 使 用 Google Now 的 界面 


注意 : 只 有 在 设备 中 登录 并 绑 定 Google 账号 后 才能 使 用 Google Now 功能 ， 国 产 行货 手机 没有 内 置 添 
加 Google 账号 功能 ， 读 者 需要 在 获取 Root 权限 后 进行 添加 设置 。 
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Фм 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 17 3 Android Wear 详解 .avi 

2014 年 3 月 ， 继 谷歌 眼镜 之 后 ， 谷 歌 推出 了 Android Wear 可 穿戴 平台 ， 正 式 进军 智能 手表 领域 。 
与 之 前 传闻 不 同 的 是 ， 谷 歌 并 未 推出 硬件 ， 这 意味 着 什么 ? 显然 ， 作 为 一 个 平台 服务 商 ， 谷 歌 的 目标 
不 仅仅 是 一 款 卖 得 好 的 智能 手表 ， 而 是 一 统 整个 穿戴 式 计算 机 行业 。 对 于 用 户 而 言 ，Android Wear 将 
改变 目前 智能 手表 领域 缺乏 标准 、 各 自 为 营 的 混乱 状况 ， 同 时 也 能 够 与 自己 的 Android 手机 获得 更 无 
颖 化 的 数据 共享 。 本 节 将 简单 看 一 看 Android Wear 平台 给 我 们 带 来 了 怎样 的 前 景 和 未 来 。 


17.2.1 什么 是 Android Wear 


可 以 将 Android Wear 看 作 是 一 个 针对 智能 手表 等 可 穿戴 设备 优化 的 Android 版 本 ，Android Wear 
界面 更 适合 小 屏幕 ， 主 要 功能 是 面向 手机 与 手表 互联 带 来 的 新 型 移动 体验 。 举 个 例子 来 说 ， 平 常 乘坐 
公交 车 时 难免 会 遇 到 坐 过 站 的 情况 ， 只 要 在 Android Wear 手表 中 设 定好 目的 地 ，GPS 便 会 开始 定位 ， 
及 时 提醒 我 们 “还 有 1 站 到 达 大 明湖 ” 这 样 就 能 够 避免 发 生 坐 过 站 的 情况 。 

从 本 章 前 面 讲解 的 内 容 可 知 ，Google Now 应 用 一 直 致 力 于 通过 上 下 文联 想 技术 提供 全 面 、 智 能 的 
搜索 体验 ， 现 在 Google Now 被 集成 到 Android Wear 中 ， 不 需要 任何 按键 ， 只 需 说 “OK Google” 以 及 
用 户 想 知道 的 内 容 或 是 进行 的 操作 即 可 。 

谷歌 在 视频 中 演示 了 相当 丰富 的 使 用 场景 ， 例 如 用 户 要 去 海滩 冲浪 ，Android Wear 手表 会 自动 弹 
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出 “海里 有 海 拨 ”的 警告 ;在 收 到 短信 场景 时 ， 可 以 直接 语音 回复 即 可 ; 在 登 机 场景 中 ， 直 接 出 示 手 
表 中 的 机 票 二 维 码 就 可 以 完成 登 机 工作 。 
另外 ,健身 应 用 也 是 Android Wear 必 备 的 一 个 功能 。 Android Wear 能 够 实时 监测 我 们 的 活动 状态 ， 
记录 步 数 及 热量 消耗 。 当 然 ， 健 身 功能 实际 上 还 有 很 大 的 发 展 空间 ， 相 信 谷 歌 和 手表 制造 商会 在 日 后 
为 用 户 提供 更 多 样 化 的 健康 监测 形式 ， 如 手表 背面 内 置 传感器 监测 用 户 体温 和 心率 等 。 
由 此 可 见 ，Android Wear 是 将 Android 延伸 到 可 穿戴 设备 的 项 目 。 这 个 项 目 首先 从 智能 手表 开始 。 
通过 一 系列 的 新 设备 和 应 用 ，Android Wear 将 能 够 做 到 以 下 方面 。 
М 在 用 户 最 需要 的 时 候 给 出 有 用 的 信息 : 从 用 户 最 喜欢 的 社交 应 用 获取 更 新 ， 使 用 通信 应 用 交 
流 ， 从 购物 应 用 、 新 闻 应 用 那里 获取 通知 等 。 
М 直接 回答 用 户 的 问题 : 说 一 声 “OK Google” 来 提出 问题 ， 如 航班 离开 的 时 间 、 游 戏 的 分 数 ， 
或 者 完成 某 件 事情 〈 如 呼叫 出 租车 、 发 短信 、 预 定 餐 厅 或 者 设置 闹钟 )。 
Ep ”更 好 地 监控 用 户 的 健康 : 通过 Android Wear 上 的 提醒 和 健康 信息 ， 达 到 自己 健身 的 目标 。 用 
户 最 爱 的 健身 应 用 能 够 提供 实时 的 速度 、 距 离 和 时 间 信 息 。 
М ” 通 向 多 屏 世 界 的 钥匙 : Android Wear 能 让 用 户 控制 其 他 设备 。 用 “Ok Google” 打 开 手 机 上 的 
音乐 列表 ， 或 者 将 最 喜欢 的 电影 投射 到 电视 上 面 。 在 开发 者 的 参与 下 ， 还 会 有 更 多 的 可 能 性 。 
目前 , 摩托 罗拉 和 LG 已 经 展示 了 概念 的 Android Wear 
手表 ， 预 计 三 星 、HTC、 华 硕 等 厂商 都 会 后 续 跟 进 。 首 先 
来 看 看 摩托 罗拉 的 Moto 360 手表 ， 它 拥有 一 个 接近 传统 手 
表 的 圆 形 金属 表盘 ， 适 合 在 所 有 场合 佩戴 。 摩 托 罗 拉 公 司 
也 承诺 将 使 用 精良 的 材质 ， 保 持 佩戴 的 舒适 性 ， 如 图 17-7 
所 示 。 


17.2.2 4832 Android Wear 开发 环境 


图 17-7 Android Wear 手表 
现在 谷歌 已 经 公开 了 Android Wear 的 预览 版 ， 只 面向 
谷歌 账号 开发 者 用 户 公 开 。 有 具体 信息 请 登录 http:/developerandroid.com/wear/index.html, W] 17-8 所 示 。 


ES | 
Ea Android Wear 


Information that moves with 


图 17-8 Android Wear 官方 站 点 


单 击 图 17-8 中 的 Get the Developer Preview 按钮 ， 进 入 Android Wear 开发 者 预览 界面 ， 在 此 列 出 
了 搭建 开发 环境 的 方法 和 开发 资料 ， 如 图 17-9 所 示 。 
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anaz Developer Previe а 
Get Started Get Started with the Developer Preview 
Ut overview 
The Android Wear Developer Preview 
Design Principles includes tools and APIs that allow you to 
enhance your app notifications to provide an 
Creating Notifications for optimized user experience on Android 
Android Wear каша 
Receiving Voice Input from a 
MN Дә With the Android Wear Developer Preview, 
you car: 
‘Adding Pages to а Notification — , Ruy the Android Wear platform in the 
‘Stacking Notifications CARLOS 
* Connect your Android device to the 
Notification Reference ‘emulator and view notifications from the 
device as cards on Android Wear. < 
License Agreement * Try new APIs in the preview support mn Union wwe = 
library that enhance your арр 


notifications with features cuch as voice Signing up provides you access to: 


replies and notification pages. 
+ New notification APIs in the preview support library. 


To get access to the Developer Preview < Sample apos using the new notification APIs. 
tools, click the sign up button on the fight. тһе Android Wear Preview app for your mobile device, which 
thenfolow he setupinstructions belom. “Syncs your eve othe Ano Vea elt 


17-9 Android Wear 开发 者 预览 界面 


Android Wear 开发 环境 和 Android 应 用 开发 环境 类 似 ， 具 体 过 程 如 下 : 
(1) 根据 第 2 章 的 内 容 安装 Android SDK, fE Android SDK 中 包括 了 Android Wear 的 所 有 开发 工具 。 
(2) 单 击 图 17-9 中 的 按钮 进入 注册 界面 ， 在 此 界面 注册 为 Android Wear 预览 开发 者 ， 如 图 17-10 
所 示 。 


[Amphitheatre Parkway, Mountain View, СА 94043, United States. 3 
Get Started 
Important: Your email address is used to provide your Google account access to the Android Wear Preview 
Ul Overview app Beta Preview on Google Play Store. As such, the email address you provide below must be for the 
account you use to download appo on Google Play Store. We may also use your email address to provide you 
Design Principles with updates about the Android Wear platform release 
Creating Notifications for 
Android Wear 
Ë um 
Receiving Voice input from a 
Notification What is your Gmail or Google account email address? 


Adding Pages to a Notification 
What is your name? (Optional) 


Stacking Notifications 


Notification Reference + — Whatis your company namo? (Optional) 


License Agreement 
If you've published any apps to the Google Play Store, please provide package name(s}. (Optional) 


a g com google test 


1 have read and agree to the Terms and Conditions. * 
© Yos, lagree 


E 


DDE Googl» 表单 提交 密码 
图 17-10 注册 界面 


(3) 输入 Gmail 账户 信息 后 单 击 “ 提 交 ” 按 钮 ， 等 待 谷歌 发 送 回复 的 邮件 信息 ， 如 图 17-11 所 示 。 
通过 邮件 中 的 链接 可 以 下 载 Android Wear 预览 版 的 开发 程序 包 和 演示 实例 ， 下 载 后 的 压缩 包 是 
AndroidWearPreview.zip， 解 压缩 后 的 效果 如 图 17-12 所 示 。 
(4) 检查 Android SDK 工具 的 版 本 22.6 或 更 高 ， 如 果 当 前 Android SDK 工具 的 版 本 低 于 22.6, 
则 必须 进行 更 新 。 
(5) 在 图 17-13 所 示 的 界面 中 创建 一 个 Android 模拟 器 ，Android Wear 要 求 的 最 低 版 本 是 Android 


4.4.2， 选 择 Android Wear ARM(armeabi-v7a)。 
x) 


Быел 


‘Android Wear Developer Preview - Sign Up Confirmation aem x = 
noreply@google.com 35198 ^ 
ERE 

t ax алт вана маха 
Halo Developer 


Thank you for signing up for the Android Wear Developer Preview 


To begin developing on Android Wear. you need the Preview Support library and the. reds Wear Preview app 
Tor your moole device. Folow mese steps: 


* Downtcad the Preview Support library and samples. 

* Opt-in to become a tester of the Android Wear Preview app in tne Googie Play Store. Aner opt-in, t coud 
take up to 24 hours for the Android Wear Preview app to be accessible to you in Google Play. Make sure 
the opt-in user account is the same user signed in 10 Google Play 


Refer to the Android Wear Developer Get Started page for details. Since this is a preview release, please do not 
publicly distribute apps built with the Preview Ibrary Also note that the APIs are potentialy subject to change and 
You wil neec to тоту your apps when теу are геєаѕеа out of preview 


Snare your experiences and ask questions by joining tne Android Wear Developers Google+ Community We look 
forward to seeing nov your apps take advantage of these new APIs to provide innovative new user expenences! 


— The Andro Wear Team 


图 17-11 谷歌 回复 的 邮件 信息 


上 samples 2014/3/18 1:27 RAR 

[Ò LICENSE 2014/3/18 1:27 文件 19 KB 
README 2014/3/18 1:27 xt 16 
(a) wearable-preview-support. jar 2014/3/18 1:27 Executable Jar. 30 кв 


17-12 解压 缩 AndroidWearPreview.zip 


Ф Android Virtw 


[Android Virtual Devices) Device Definitions | 


List of existing Android Virtual Devices located at C:\Users\apple\. android\avd 


AVD Mane Target Nae та [wT [a 
V Android 4,0 40 14 AMD (unesbi-via) 


МЇ А valid Android Virtual Device, A repairable Android Virtual Device. 
Җ An Android Virtual Device that failed to load Click ‘Details’ to see the error. 


Р 17-13 ”准备 创建 一 个 Android 模拟 器 


C6) 单 击 图 17-13 中 的 New 按钮 ， 在 新 界面 中 进行 如 下 所 示 的 设置 。 
AVD name: 设置 创建 模拟 器 的 名 字 为 wear。 
Target: 设置 此 值 最 低 为 Android 4.4.2 - API Level 19。 
CPU/ABI: 设置 此 值 为 Android Wear ARM (armeabi-v7a)。 
Skin: 用 于 设置 Android Wear 的 外 观 , 现在 Android Wear 只 有 两 种 外 观 , 分 别 是 方形 (Android 
WearSquare) 或 圆 形 (AndroidWearRound)。 
其 他 选项 : 设置 为 默认 值 即 可 。 
设置 后 的 界面 效果 如 图 17-14 所 示 。 
单 击 OK 按钮 完成 创建 ， 单 击 Start 按钮 可 以 运行 这 个 模拟 器 ， 运 行 后 的 效果 如 图 17-15 所 示 。 
另外 ， 通 过 谷歌 回复 的 Gmail 邮件 可 知 ， 可 以 登录 https://play.google.com/apps/testing/com.google. 
android.wearablepreview.app F$ Android Wear Preview， 当 然 最 简单 的 方法 是 从 Play 商店 下 载 获 取 , 如 
图 17-16 所 示 。 
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B 17-14 创建 了 一 个 方形 Android Wear 模拟 器 


Voice actions disabled in this preview 


Swipe to dismiss 


Р 17-15 模拟 器 运行 效果 


Android Wear Preview 
我 的 应 用 s- asi 


Ё 17-16 从 Play 商店 下 载 获 取 Android Wear Preview 
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另外 , 也 可 以 登录 https;//plus.google.com/communities/113381227473021565406 进入 测试 人 员 社区 ， 
在 这 里 可 以 和 一 线 开发 人 员 进 行 交 流 ， 如 图 17-17 所 示 。 


Google+ ЖЕЛ RENARE ES 


Qus FUB о deum 


&n23012 wear 


saat v @ Amold Gupta 
q = = 


17-17 Android Wear 开发 者 交流 社 
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173 ЖЖ Android Wear 程序 


GAO 知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 17 章 \ 开 发 Android Wear 程序 .avi 
在 搭建 完 Android Wear 开发 环境 之 后 ， 接 下 来 开始 讲解 开发 Android Wear 程序 的 基本 知识 。 本 节 
将 首先 讲解 开发 Android Wear 程序 的 知识 ， 然 后 通过 一 个 演示 实例 讲解 具体 开发 过 程 。 


17.3.1 创建 通知 


当 一 个 手机 或 平板 电脑 等 Android 设备 连接 到 一 个 Android Wear 时 ， 所 有 的 通知 在 设备 之 间 都 是 
共享 的 。 在 Android Wear 中 ， 每 个 通知 都 会 以 新 卡片 背景 流 的 样式 出 现 ， 如 图 17-18 所 示 。 


it's my favorite. 


图 17-18 ”出 现 通知 
由 此 可 见 ， 无 须 经 过 多 少 工作 量 ， 便 可 以 在 Android Wear 设备 中 创建 一 个 通知 应 用 程序 。 但 是 为 
了 提高 用 户 体验 ， 当 用 户 面 对 一 个 通知 时 ， 再 通过 声音 来 回复 。 
a) 引入 需要 的 类 
在 开发 Android Wear 应 用 程序 之 前 ， 必 须 首先 详细 阅读 开发 者 预览 文档 。 在 该 文档 文件 中 提 到 ， 
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Android Wear 应 用 程序 必须 包括 V4 支持 库 和 开发 者 预览 版 支持 库 。 所 以 开始 的 时 候 , 应 该 包括 项 目 中 
的 代码 下 面 的 引入 文件 : 
import android.preview.support.wearable.notifications.*; 
import android.preview.support.v4.app.NotificationManagerCompat; 
import android .support.v4.app.NotificationCompat; 
(2) 通过 提醒 Builder 创建 通知 


在 Android Wear 中 ， 通 过 用 V4 支持 库 可 以 实现 最 新 的 通知 等 功能 ， 例 如 用 操作 按钮 和 大 图 标 创 
建 通知 。 例 如 在 下 面 的 演示 代码 中 ， 使 用 NotificationCompat API 结合 新 的 NotificationManagerCompat 
API 可 以 创建 并 发 布 通知 。 

int notificationld = 001; 

Intent viewIntent = new Intent(this, ViewEventActivity.class); 

viewIntent.putExtra(EXTRA_EVENT_ID, eventld); 

PendingIntent viewPendingIntent = 

Pendinglntent.getActivity(this, 0, viewIntent, 0); 


NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(this) 
.setSmallicon(R.drawable.ic event) 
.setContentTitle(eventTitle) 
.setContentText(eventLocation) 
.setContentIntent(viewPendingIntent); 


NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this ); 


notificationManager.notify(notificationld, notificationBuilder.build()); 
通过 上 述 代码 ， 当 上 述 通 知 出 现在 手持 设备 中 时 ， 用 户 可 以 调用 指定 的 setcontentintent() 方 法 通过 
触摸 的 方式 通知 PendingIntent。 当 这 个 通知 出 现在 Android Wear 中 时 ， 用 户 也 可 以 用 通知 操作 来 调用 
在 手持 设备 上 的 意图 。 
Сз) 添加 动作 按钮 


除了 通过 setcontentintentO 定 义 的 主要 操作 外 ， 还 可 以 通过 传递 PendingIntent 到 addaction() 方 法 的 
方式 添加 其 他 操作 。 例 如 下 面 的 代码 显示 了 和 前 面 类 型 相同 的 通知 ， 但 是 增加 了 一 个 在 地 图 上 实现 定 
位 的 事件 操作 。 

Intent maplntent = new Intent(Intent.ACTION VIEW); 

Uri geoUri = Uri.parse("geo:0,0?q=" + Uri.encode(location)); 

maplntent.setData(geoUri); 

PendingIntent mapPendingintent = 

Pendinglntent.getActivity(this, 0, mapIntent, 0); 


NotificationCompat.Builder notificationBuilder — 
new NotificationCompat.Builder(this) 
.setSmalllcon(R.drawable.ic event) 
.setContentTitle(eventTitle) 
.setContentText(eventLocation) 
.setContentIntent(viewPendinglIntent) 
.addAction(R.drawable.ic map, 


getString(R.string.map), mapPendingintent); 
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(4) 为 通知 添加 一 个 大 视图 


在 手持 设备 上 ， 用 户 可 以 通过 扩大 通知 卡片 的 方式 来 查看 通知 内 容 。 在 Android Wear 设备 中 ， 大 
视图 的 内 容 是 默认 可 见 的 。 当 在 通知 中 添加 扩展 的 内 容 后 , 可 以 调用 NotificationCompat.Builder 对 象 中 
的 setStyle0 方 法 来 实现 bigtextstyle 或 inboxstyle 样式 实例 。 


例如 在 下 面 的 代码 中 ， 添 加 了 NotificationCompat.bigtextstyle 实例 的 事件 通知 ， 这 样 可 以 包括 完整 
的 事件 描述 ， 包 括 可 以 提供 比 setcontenttext0 空 间 更 多 的 文本 内 容 。 

BigTextStyle bigStyle = new NotificationCompat.BigTextStyle(); 

bigStyle.bigText(eventDescription); 


NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(this) 
-setSmalllcon(R.drawable.ic_event) 
.setLargelcon(BitmapFractory.decodeResource( 

getResources(), R.drawable.notif background)) 

.setContentTitle(eventTitle) 
.setContentText(eventLocation) 
.setContentIntent(viewPendingIntent) 
.addAction(R.drawable.ic map, 


getString(R.string.map), mapPendingintent) 
.setStyle(bigStyle); 
注意 : 可 以 使 用 setlargeicon() 方 法 为 任何 通知 添加 一 个 背景 图 像 。 
(5) 为 设备 添加 新 的 功能 
在 Android Wear 预览 版 的 支持 库 中 提供 了 很 多 新 的 API， 通 过 这 些 API 可 以 在 穿戴 设备 中 提高 通 
知 用 户 体验 。 例 如 可 以 添加 额外 的 页 面 内 容 ， 或 添加 用 户 使 用 语音 输入 文本 的 响应 功能 。 通 过 使 用 这 
些 新 的 API 和 实例 的 NotificationCompat Builder0 构 造 函数 可 以 添加 新 的 功能 。 例 如 下 面 的 演示 代码 。 
NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(mContext) 
.setContentTitle("New mail from " + sender.toString()) 
.setContentText(subject) 
.setSmallicon(R.drawable.new mail); 


Notification notification — 


new WearableNotifications.Builder(notificationBuilder) 
.setHintHidelcon(true) 
-build(); 


在 上 述 代 码 中 ， 方 法 setHintHideIcon0 的 功能 是 从 通知 卡 中 移 除 应 用 程序 图 标 。 方 法 setHint 
HideIcon0 是 一 个 新 的 通知 功能 ， 可 以 从 WearableNotifications.Builder 对 象 中 生成 。 
当 想 要 推送 传递 的 通知 时 , 一 定 要 始终 使 用 NotificationManagerCompat API, 例如 下 面 的 演示 代码 。 


NotificationManagerCompat notificationManager = 
NotificationManagerCompat.from(this); 


notificationManager.notify(notificationld, notification); 


注意 : 在 笔者 写作 此 书 时 ，Android Wear 开发 者 预览 版 API 只 是 为 了 开发 和 测试 而 推出 的 ， 并 不 是 为 
了 编写 出 具体 应 用 程序 。 谷 歌 在 正式 公布 Android Wear SDK 之 前 ， 上 述 开发 流程 只 是 待定 的 。 
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1732 ”创建 声音 


如 果 在 创建 的 通知 中 包含 了 文本 回复 功能 ， 例 如 回复 一 封 邮件 ， 在 通常 情况 下 会 在 手持 设备 上 启 
动 一 个 Activity。 当 通知 显示 在 穿戴 设备 上 时 ， 可 以 允许 用 户 使 用 语音 输入 口述 一 个 回复 ， 还 可 以 提供 
预先 设置 的 文本 信息 让 用 户 选择 。 当 用 户 使 用 语音 回复 或 者 选择 预 设 信息 时 ， 系 统 会 发 送信 息 到 与 手 
持 设备 相连 的 应 用 ,该 信息 以 一 个 附加 品 的 形式 与 我 们 定义 使 用 的 通知 行动 的 Intent 相关 联 , 如 图 17-19 
所 示 。 


图 17-19 声音 回复 


注意 : 在 安 车 模拟 器 上 开发 时 ， 即 使 在 语音 输入 域 ， 也 必须 使 用 文本 回复 ， 所 以 要 确保 在 AVD 设置 上 
已 激活 了 Hardware keyboard present。 


(1) 定义 远程 回复 
在 Android Wear 中 创建 支持 语音 输入 的 行动 时 ， 首 先 需 要 使 用 RemoteInput Builder APIs 创建 一 个 
RemoteInput 的 实例 。RemoteInput Builder 构造 器 获取 一 个 String 类 型 的 值 ， 系 统 会 将 这 个 值 作为 一 个 
key 传递 给 Intent extra， 这 个 Intent 可 以 将 回复 信息 传送 到 手持 设备 中 的 应 用 程序 。 例 如 在 下 面 的 代码 
中 创建 了 一 个 新 的 RemoteInput 对 象 ， 功 能 是 提供 自 定义 标签 给 语音 输入 命令 。 
/传送 给 行动 intent 的 key 的 字符 串 
private static final String EXTRA_VOICE_REPLY = "extra voice reply"; 
String replyLabel = getResources().getString(R.string.reply_label); 
Remotelnput remotelnput = new Remotelnput.Builder(EXTRA VOICE REPLY) 
-SetLabel(replyLabel) 
-build(); 
(2) 添加 预 置 文本 进行 回复 
除了 支持 语音 输入 外 ， 在 Android Wear 中 还 可 以 提供 最 多 5 条 预 置 文本 回复 信息 ， 以 供用 户 进行 
快速 回复 。 实 现 方法 是 调用 setChoices() 方 法 ， 并 将 字符 串 数 组 传递 给 它 。 例 如 可 以 在 资源 数组 中 定义 
如 下 所 示 的 回复 。 
res/values/strings.xml 
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string-array name="reply_choices"> 
<item>Yes</item> 
<item>No</item> 
<item>Maybe</item> 
</string-array> 
</resources> 


执行 效果 如 图 17-20 所 示 。 
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图 17-20 添加 的 回复 数值 


然后 通过 如 下 代码 释放 String 数组 并 将 其 添加 到 RemoteInput 中 。 
String replyLabel = getResources().getString(R.string.reply_label); 
String[] replyChoices = getResources().getStringArray(R.array.reply_choices); 


Remotelnput remotelnput = new Remotelnput.Builder(EXTRA VOICE REPLY) 
-SetLabel(replyLabel) 
-SetChoices(replyChoices) 
-build(); 
(3) 为 主 行动 接收 语音 输入 
在 Android Wear 应 用 中 ， 如 果 Reply 是 应 用 程序 的 主 行动 (由 setContentIntent() 方 法 定义 )， 那 么 
需要 使 用 addRemoteInputForContentIntent() 方 法 将 RemoteInput 添加 到 主 行动 上 .例如 下 面 的 演示 代码 。 
// 为 回复 行动 创建 intent 
Intent replyIntent = new Intent(this, ReplyActivity.class); 
PendingIntent replyPendingIntent = 
Pendingintent.getActivity(this, 0, replyIntent, 0); 
// 创 建 通知 
NotificationCompat.Builder replyNotificationBuilder = 
new NotificationCompat.Builder(this) 
-SetSmalllcon(R.drawable.ic_new_message) 
.setContentTitle("Message from Travis") 
.setContentText("I love key lime pie!") 
.setContentIntent(replyPendinglntent); 
// 创 建 运程 回复 < 语音 > 
Remotelnput remotelnput = new Remotelnput.Builder(EXTRA_VOICE_REPLY) 
.SetLabel(replyLabel) 
-build(); 
// 创 建 穿戴 设备 的 通知 并 添加 语音 输入 
Notification replyNotification = 
new WearableNotifications.Builder(replyNotificationBuilder) 
-addRemotelnputForContentIntent(remotelnput) 
-build(); 
通过 使 用 addRemoteInputForContentIntent() 77:1 RemoteInput 对 象 添加 到 通知 的 主 行动 中 后 ， 通 
常 Open 按钮 会 显示 为 Reply 按钮 ， 当 用 户 在 Android Wear 上 选择 它 时 ， 它 就 会 启动 语音 输入 UI 视图 
界面 。 
(4) 为 次 行动 设置 语音 输入 
WR Reply 动作 不 是 我 们 创建 通知 的 主动 作 ， 而 只 是 为 次 行动 激活 语音 输入 ， 那 么 可 以 添加 
RemoteInput 到 新 的 行动 按钮 (由 Action 对 象 定义 )。 通 过 Action.Builder0 构 造 器 实例 化 Action, ES 
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给 行动 按钮 添加 一 个 icon 和 文本 标签 ， 加 上 PendingIntent， 当 用 户 选 择 这 个 行动 时 ， 系 统 会 使 用 它 调 
用 应 用 。 例 如 下 面 的 演示 代码 。 
/创建 一 个 pending intent， 当 用 户 选 择 这 个 行动 时 ， 会 启用 这 个 intent 
Intent replyIntent = new Intent(this, ReplyActivity.class); 
PendingIntent pendingReplyIntent = 
Pendinglntent.getActivity(this, 0, replyIntent, 0); 


// 创 建 远程 输入 

Remotelnput remotelnput = new Remotelnput.Builder(EXTRA VOICE REPLY) 
.setLabel(replyLabel) 
-build(); 


// 创 建 通知 行动 

Action replyAction = new Action.Builder(R.drawable.ic_message, 
"Reply", pendingIntent) 
.addRemotelnput(remotelnput) 
-build(); 

然后 为 Action 添加 Remotelnput.Builder, 使 用 addAction() 77 iN WearableNotifications.Builder 添加 

Action。 例 如 下 面 的 演示 代码 。 

// 创 建 基本 的 通知 创建 者 

NotificationCompat.Builder replyNotificationBuilder = 
new NotificationCompat.Builder(this) 
.setContentTitle("New message"); 


/ 创建 通知 行动 并 添加 远程 输入 

Action replyAction = new Action.Builder(R.drawable.ic_message, 
"Reply", pendingIintent) 
.addRemotelnput(remotelnput) 
-build(); 


/ 创建 穿戴 设备 的 通知 并 添加 行动 
Notification replyNotification = 
new WearableNotifications.Builder(replyNotificationBuilder) 
-addAction(replyAction) 
-build(); 
现在 ， 当 用 户 在 Android Wear 设备 上 选择 Reply 时 ， 系 统 提 示 用 户 使 用 语音 输入 〈 如 果 提 供 了 预 
置 回 复 ， 则 会 显示 预 置 列表 )。 当 用 户 完 成 回复 时 ， 系 统 会 调用 与 该 行动 关联 的 intent， 并 添加 作为 字 
符 值 的 EXTRA VOICE REPLY extra (传递 给 RemoteInput Builder 构造 器 的 字符 串 ) 到 用 户 信息 。 


17.3.3 ”给 通知 添加 页 面 


当 想 为 Android Wear 设备 提供 更 多 的 信息 ， 而 且 不 需要 用 户 使 用 手持 设备 打开 应 用 时 ， 可 以 在 
Android Wear 上 为 通知 添加 一 个 或 若干 个 页 面 ， 附 加 的 页 面 会 在 主 通知 卡片 的 右边 立即 显示 出 来 ， 如 


图 17-21 所 示 。 
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bread, good cheese, 
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Picnic with Rachel 


图 17-21 给 通知 添加 页 面 


当 创 建 多 张 页 面 时 ， 第 一 步 需要 把 通知 显示 在 手机 或 平板 设备 ， 也 就 是 先 创建 一 个 主 通知 (第 一 
张 页 面 )， 然 后 使 用 addPage0 方 法 每 次 添加 一 张 页 面 ， 或 者 使 用 addPages() 方 法 从 Collection 对 象 添加 
若干 页 面 。 例 如 下 面 的 演示 代码 。 
// 为 主 通知 创建 Builder 
NotificationCompat.Builder notificationBuilder = 
new NotificationCompat.Builder(this) 
.SetSmalllcon(R.drawable.new_message) 
-SetContentTitle("Page 1") 
.setContentText("Short message") 
-SetContentintent(viewPendingIntent); 


// 为 第 二 张 页 面 创建 big text 风格 
BigTextStyle secondPageStyle = new NotificationCompat.BigTextStyle(); 
secondPageStyle.setBigContentTitle("Page 2") 

-bigText("A lot of text..."); 


Notification secondPageNotification = 
new NotificationCompat.Builder(this) 
-SetStyle(secondPageStyle) 
-build(); 


Notification twoPageNotification = 
new WearableNotifications.Builder(notificationBuilder) 
.addPage(secondPageNotification) 
-build(); 


17.3.4 ЯЖ 


当 为 手持 设备 创建 通知 时 ， 大 家 可 能 习惯 于 把 同类 型 的 通知 放 在 一 个 汇总 通知 中 。 例 如 ， 如 果 应 
创建 了 接收 信息 的 通知 ， 当 接收 到 多 条 信息 时 不 会 显示 多 条 通知 在 手持 设备 上 ， 而 是 使 用 单条 通知 。 
时 只 需要 提供 汇总 信息 即 可 ， 例 如 “两 条 新 信息 ”的 提示 。 但 是 在 Android Wear 设备 上 ， 汇 总 信息 
股 什么 作用 ， 因 为 用 户 无 法 在 Android Wear 设备 上 逐条 阅读 细节 〈 因 为 他 们 必须 在 手持 设备 上 打开 应 
查看 更 多 信息 )。 为 了 Android Wear 设备 ， 需 要 把 所 有 的 通知 聚集 到 一 个 堆 中 。 通 知 堆 以 单 张 卡片 的 
式 存 在 ， 用户 可 以 展开 它 逐 条 查看 ,新 的 setGroup() 方 法 提供 了 可 能 ， 虽 然 在 手持 设备 上 它 仍然 仅 提 
kt 一 条 汇总 信息 ， 如 图 17-22 所 示 。 


@ 


a 


m 


FNI 


#178 Google Now 和 Android Wear à 


— ata D) 


Check this out 

Check this out Look at all these 
Look at all these reat annenannie are 
„ЖЕУ Чем 


|| Launch party 


*5mae 


图 17-22 ”通知 堆 演 示 界 面 
(1) 将 通知 逐条 添加 到 Group 
为 了 在 Android Wear 中 创建 堆 ， 需 要 为 每 条 通知 调用 setGroup0 方 法 ， 并 将 唯一 的 group key 传递 


给 它们 。 例 如 下 面 的 演示 代码 。 
final static String GROUP_KEY_EMAILS = "group_key_emails"; 
NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext) 
.setContentTitle("New mail from " + sender) 


.setContentText(subject) 
.setSmalliIcon(R.drawable.new mail); 


Notification notif = new WearableNotifications.Builder(builder) 
.setGroup(GROUP KEY EMAILS) 
-build(); 
在 默认 情况 下 ， 会 以 添加 顺序 来 展现 通知 ， 最 新 的 通知 显示 在 头 部 。 但 是 也 可 以 通过 传递 一 个 位 


置 值 给 setGroup0 的 第 二 个 参数 ， 在 group 中 定义 一 个 特殊 的 位 置 。 
(2) 添加 一 个 汇总 通知 
在 Android Wear 应 用 中 ， 提 供 一 个 汇总 通知 给 手持 设备 是 很 重要 的 。 除 了 逐条 添加 通知 到 同一 个 
通知 堆 外 ， 建 议 仍 添加 一 个 汇总 通知 ， 不 过 设置 它 的 次 序 为 GROUP. ORDER_SUMMARY。 例 如 下 面 
的 演示 代码 。 
Notification summaryNotification = new WearableNotifications.Builder(builder) 
.setGroup(GROUP_KEY_EMAILS, WearableNotifications. GROUP_ORDER_SUMMARY) 


.build(); 
这 条 通知 不 会 显示 在 Android Wear 设备 上 的 通知 堆 中 ， 只 会 显示 在 手持 设备 上 的 唯一 通知 上 。 


17.3.5 ”通知 语法 介绍 

(1) android.preview.support.v4.app 

用 NotificationCompat Builder 对 象 来 设 定 通知 的 UI 信息 和 行为 ， 调 用 NotificationCompat.Builder. 
build0 来 创建 通知 ， 调 用 NotificationManagernotify0 来 发 送 通知 。 


一 条 通知 必须 包含 如 下 信息 。 
一 个 小 图 标 : 用 setSmallIcon0 来 设置 。 


M 
М =“: 用 setContentTitle0 来 设置 。 
M ”详情 文字 : 用 setContentText0 来 设置 。 
(2) android.preview.support.wearable.notifications 
这 是 一 个 提醒 接口 类 ， 在 里 面 定义 了 如 表 17-1 所 示 的 类 。 
x) 
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表 17-1 提醒 类 

RemoteInput 远程 输入 类 ， 可 穿戴 设备 输入 
RemotelInput.Builder ÆR RemoteInput 的 目标 
WearableNotifications 可 穿戴 设备 类 型 的 通知 
WearableNotifications.Action 可 穿戴 设备 类 型 通知 的 行为 动作 
WearableNotifications.Action.Builder | 生成 类 WearableNotifications.Action 对 象 
WearableNotifications.Builder 一 个 NotificationCompat.Builder 生成 器 对 象 ， 为 可 穿戴 的 扩展 功能 提供 通知 方法 


例如 在 下 面 的 代码 中 ， 通 过 注释 详细 讲解 并 演示 了 各 个 Android Wear 对 象 的 基本 用 法 。 
int notificationld = 001; /通知 id 
Intent replyIntent = new Intent(this, ReplyActivity.class); //Д@ Ку Action, TJ MAZ) Activity, Service s; Broadcast 


Pendinglntent pendingIntent = Pendingintent.getActivity(this, 0, replyIntent, 0); 
Remotelnput remotelnput = new Remotelnput.Builder("key")/ 响 应 输入 ，“key” 为 返回 Intent 的 Extra 的 Key f& 


.setLabel("Select") // 输 入 页 标题 
.setChoices(String[]) /输入 可 选项 
-build(); 
Action replyAction = new Action.Builder(R.drawable, //WearableNotifications.Action.Builder 对 应 可 穿戴 设备 的 
Action 类 


"Reply", pendingIntent) /对 应 pendingIntent 
.addRemotelnput(remotelnput) 
-build(); 


NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(mContext) /标准 通知 创建 
.setContentTitle(title).setContentText(subject).setSmalllcon(R.drawable).setStyle(style) 
.setLargelcon(bitmap) // 设置 可 穿戴 设备 显示 的 背景 图 
-SetContentintent(pendingIntent) // 可 穿戴 设备 左 滑 ， 有 默认 Open 操作 ， 对 应 手机 端的 点 击 通知 
.addAction(R.drawable, String, pendinglntent); /增加 一 个 操作 ， 可 加 多 个 
Notification notification = new WearableNotifications.Builder(notificationBuilder) ” // 创 建 可 穿戴 类 通知 ， 为 通知 
增加 可 穿戴 设备 新 特性 ， 必 须 与 兼容 包 中 的 NotificationManager 对 应 ， 否 则 无 效 


.setHintHidelcon(true) II {Дея 
.addPages(notificationPages) /增加 Notification 页 
.addAction(replyAction) /| 对 应 上 页 ，pendinglntent 可 操作 项 


.addRemotelnputForContentIntent(replyAction) /可 为 Contentintent 替换 默认 的 Open 操作 
.setGroup(GROUP_KEY, WearableNotifications.GROUP_ORDER_SUMMARY) ”// 为 通知 分 组 
.setLocalOnly(true) // 可 设置 只 在 本 地 显示 

.SetMinPriority() /设置 只 在 可 穿戴 设备 上 显示 通知 


.build(); 
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);//2&48 Manager 


notificationManager.notify(notificationld, notificationBuilder.build()); /发 送 通 知 
174 ”实战 演练 一 一 开发 一 个 Android Wear 程序 


知识 点 讲解 : 光盘 :视频 \ 知 识 点 \ 第 17 章 \ 开 发 一 个 Android Wear 程序 .avi 
本 节 将 通过 一 个 具体 实例 来 讲解 开发 一 个 Android Wear 程序 的 方法 。 
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本 实例 的 具体 实现 流程 如 下 。 
(1) 编写 布局 文件 activity main.xml， 具 体 实 现代 码 如 下 : 
<RelativeLayout xmins:android="http://schemas.android.com/apk/res/android" 
xmins:tools="http://schemas.android.com/tools" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:paddingLeft-"(gdimen/activity horizontal margin" 
android:paddingRight-"(dimen/activity horizontal margin" 
android:paddingTop-"(dimen/activity vertical margin" 
android:paddingBottom-"(g)dimen/activity vertical margin" 
tools:context="com.ezhuk.wear.MainActivity"> 
<TextView 
android:text="@string/hello_world" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 
</RelativeLayout> 
(2) 编写 值 文件 strings.xml， 功 能 是 设置 通知 的 文本 内 容 ， 具 体 实现 代码 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app_name">Wear</string> 
<string name="hello_world">Test</string> 
<string name="content_title">Basic Notification</string> 
<string name="content_text">Sample text.</string> 
«string name="page1_title">Page 1</string> 
«string name="page1_text">Sample text 1.</string> 
«string name="page2_title">Page 2</string> 
<string name="page2_text">Sample text 2.</string> 
«string name="action_title">Action Title</string> 
<string name="action_text">Action text.</string> 
<string name="action_button">Action</string> 
<string name="action_label">Action</string> 
«string name="summary_title">Summary Title</string> 
<string name="summary_text">Summary text.</string> 
<string-array name="input_choices"> 
<item>First item</item> 
<item>Second item</item> 
<item>Third item</item> 
</string-array> 
</resources> 
(3) 编写 文件 MainActivityjava 实现 程序 的 主 Activity， 功 能 是 载 入 Android Wear 的 通知 类 
NotificationUtils， 调 用 不 同 的 showNotificationXX 方法 显示 通知 信息 ， 有 具体 实现 代码 如 下 : 
package com.ezhuk.wear; 


import android.app.Activity; 
import android.os.Bundle; 
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import static com.ezhuk.wear.NotificationUtils.*; 


public class MainActivity extends Activity { 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity_main); 


} 


@Override 
protected void onResume() { 
super.onResume(); 


showNotification(this); 
showNotificationNolcon(this); 
showNotificationMinPriority(this); 
showNotificationBigT extStyle(this); 
showNotificationBigPictureStyle(this); 
showNotificationInboxStyle(this); 
showNotificationWithPages(this); 
showNotificationWithAction(this); 
showNotificationWithInputForPrimaryAction(this); 
showNotificationWithInputForSecondaryAction(this); 
showGroupNotifications(this); 


} 


@Override 
protected void onPause() { 
super.onPause(); 

} 

} 
(4) 编写 文件 NotificationUtils.java， 功 能 是 定义 各 种 不 同类 型 showNotificationXX 的 通知 方法 ， 
具体 实现 代码 如 下 : 

import android.app.Notification; 
import android.app.Pendinglntent; 
import android.content.Context; 
import android.content.Intent; 
import android.graphics.BitmapFactory; 
import android.net.Uri; 
import android.preview.support.v4.app.NotificationManagerCompat; 
import android.preview.support.wearable.notifications.Remotelnput; 
import android.preview.support.wearable.notifications. WearableNotifications; 
import android.support.v4.app.NotificationCompat; 


public class NotificationUtils ( 
private static final String ACTION TEST = "com.ezhuk.wear.ACTION"; 
private static final String ACTION. EXTRA = "action"; 


private static final String NOTIFICATION GROUP = "notification group"; 
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public static void showNotification(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
-setSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(0, 
new WearableNotifications.Builder(builder) 
-build()); 
} 


public static void showNotificationNolcon(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmallicon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(1 , 
new WearableNotifications.Builder(builder) 
-SetHintHidelcon(true) 
-build()); 
} 


public static void showNotificationMinPriority(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
-SetSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.content title)) 
.setContentText(context.getString(R.string.content text)); 


NotificationManagerCompat.from(context).notify(2, 
new WearableNotifications.Builder(builder) 
.setMinPriority() 
-build()); 
} 


public static void showNotificationWithStyle(Context context, 
int id, 
NotificationCompat.Style style) { 
Notification notification = new WearableNotifications.Builder( 
new NotificationCompat.Builder(context) 
.setSmallicon(R.drawable.ic launcher) 
.setStyle(style)) 
build(); 


NotificationManagerCompat.from(context).notify(id, notification); 
} 


public static void showNotificationBigTextStyle(Context context) { 
showNotificationWithStyle(context, 3, 
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new NotificationCompat.BigTextStyle() 
-setSummaryText(context.getString(R.string.summary_text)) 
.setBigContentTitle("Big Text Style") 
-bigText("Sample big text.")); 
} 


public static void showNotificationBigPictureStyle(Context context) { 
showNotificationWithStyle(context, 4, 
new NotificationCompat.BigPictureStyle() 
.setSummaryText(context.getString(R.string.summary text)) 
.setBigContentTitle("Big Picture Style") 
-bigPicture(BitmapFactory.decodeResource( 
context.getResources(), R.drawable.background))); 


} 


public static void showNotificationInboxStyle(Context context) { 
showNotificationWithStyle(context, 5, 
new NotificationCompat.InboxStyle() 
.setSummaryText(context.getString(R.string.summary. text)) 
.setBigContentTitle("Inbox Style") 
-addLine("Line 1") 
.addLine("Line 2")); 
} 


public static void showNotificationWithPages(Context context) { 
NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
-SetSmalllcon(R.drawable.ic_launcher) 
.setContentTitle(context.getString(R.string.page1 title)) 
.setContentText(context.getString(R.string.page1 text)); 


Notification second = new NotificationCompat.Builder(context) 
.setSmalliIcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.page2 title)) 
-SetContentText(context.getString(R.string.page2_text)) 
-build(); 


NotificationManagerCompat.from(context).notify(6, 
new WearableNotifications.Builder(builder) 
.addPage(second) 
.build()): 
} 


public static void showNotificationWithAction(Context context) { 
Intent intent = new Intent(Intent ACTION_VIEW); 
intent.setData(Uri.parse("")); 
Pendingintent pendingIntent = 
PendingIntent.getActivity(context, 0, intent, 0); 


NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmallicon(R.drawable.ic launcher) 
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.setContentTitle(context.getString(R.string.action title)) 

.setContentText(context.getString(R.string.action text)) 

.addAction(R.drawable.ic launcher, 
context.getString(R.string.action button), 
pendingIntent); 


NotificationManagerCompat.from(context).notify(7, 
new WearableNotifications.Builder(builder) 
-build()); 
} 


public static void showNotificationWithInputForPrimaryAction(Context context) { 
Intent intent = new Intent(ACTION_TEST); 
PendinglIntent pendinglIntent = 
Pendinglntent.getActivity (context, 0, intent, 0); 


NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setSmallicon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.action title) 
.setContentText(context.getString(R.string.action text)) 
-SetContentintent(pendingintent); 


String[] choices = 
context.getResources().getStringArray(R.array.input_choices); 


Remotelnput remoteinput = new Remotelnput.Builder(ACTION EXTRA) 
-SetLabel(context.getString(R.string.action_label)) 
.setChoices(choices) 

-build(); 


NotificationManagerCompat.from(context).notify(8, 
new WearableNotifications.Builder(builder) 
.addRemotelnputForContentIntent(remotelnput) 
-build()); 
} 


public static void showNotificationWithInputForSecondaryAction(Context context) { 
Intent intent = new Intent(ACTION TEST); 
PendinglIntent pendingintent = 
Pendingintent.getActivity(context, 0, intent, 0); 


Remotelnput remotelnput = new Remotelnput.Builder(ACTION EXTRA) 
-SetLabel(context.getString(R.string.action_label)) 
.build(); 


WearableNotifications.Action action = 
new WearableNotifications.Action.Builder( 
R.drawable.ic launcher, 
"Action", 
pendingintent) 
.addRemotelnput(remotelnput) 
build(); 
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NotificationCompat.Builder builder = 
new NotificationCompat.Builder(context) 
.setContentTitle(context.getString(R.string.action title)); 


NotificationManagerCompat.from(context).notify(9, 
new WearableNotifications Builder(builder) 
-addAction(action) 
-build()); 
} 


public static void showGroupNotifications(Context context) { 
Notification first = new WearableNotifications.Builder( 

new NotificationCompat.Builder(context) 
.setSmalliIcon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.page1 title)) 
.setContentText(context.getString(R.string.page1 text))) 

.setGroup(NOTIFICATION GROUP) 

-build(); 


Notification second = new WearableNotifications. Builder( 
new NotificationCompat.Builder(context) 
.setSmallicon(R.drawable.ic launcher) 
.setContentTitle(context.getString(R.string.page2 title)) 
.setContentText(context.getString(R.string.page2 text))) 
.setGroup(NOTIFICATION GROUP) 
-build(); 


Notification summary = new WearableNotifications.Builder( 
new NotificationCompat.Builder(context) 
-SetSmalllcon(R.drawable.ic_launcher) 
-SetContentTitle(context.getString(R.string.summary_title)) 
-SetContentText(context.getString(R.string.summary_text))) 
.setGroup(NOTIFICATION GROUP, WearableNotifications.GROUP_ORDER_SUMMARY) 
-build(); 


NotificationManagerCompat.from(context).notify(10, first); 

NotificationManagerCompat.from(context).notify(11, second); 

NotificationManagerCompat.from(context).notify(12, summary); 
} 


public static void cancelNotification(Context context, int id) { 
NotificationManagerCompat.from(context).cancel(id); 


} 


public static void cancelAllNotifications(Context context) { 
NotificationManagerCompat.from(context).cancelAll(); 
} 
} 
至 此 ， 一 个 简单 的 Android Wear 通知 程序 创建 完毕 。 执 行 后 会 实现 通知 功能 ， 如 图 17-23 所 示 。 
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图 17-23 执行 效果 
有 关 Android Wear 更 多 的 演示 程序 ， 读 者 可 以 参考 官方 文档 中 的 演示 实例 。 


17.5 实战 演练 一 一 实现 手机 和 Android Wear 的 交互 


бы 知识 点 讲解 :光盘 :视频 \ 知 识 点 \ 第 17 章 \ 实 现 手机 和 Android Wear 的 交互 .avi 
本 节 将 通过 一 个 具体 实例 来 讲解 将 手机 应 用 中 的 通知 信息 发 送 到 Android Wear 的 方法 ， 介 绍 在 
Android Wear 中 显示 通知 提示 信息 的 过 程 。 


本 实例 的 具体 实现 流程 如 下 。 
(1) 打开 Eclipse， 在 AVD Manager 窗口 中 新 建 一 个 Android Wear 模拟 器 ， 具 体 设 置 如 图 17-24 
所 示 。 
(2) 在 设备 中 启动 Android 应 用 程序 ， 并 单 击 Connect (连接) 按钮 ， 如 图 17-25 Bras. 


$00... Edit Android virtual Device (AvD). 
AVD Name: [AndroidWeariound 
Devis Android Wear Round (320 x 320: nap) 
Target ‘Android 4.4.2 - API Level 19 
Android Wear ARM (armeabi-v7a) 
көзге: М Hardware короле present 
75 
зт Androidieariound 
Emulator 
Front Camera 
Back Camera 
Not connected 
Memory Options; RAME [512 эмнер эг 
Internat storage: — (200 ма 
so Card 
sae мв 
File . 
Emulation Opoons. C Seapshot C) use Most cru 
оета Avo Ww m. 
ont) =a 


图 17-24 新 建 一 个 Android Wear 模拟 器 17-25 i Connect GEH) 按钮 
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(3) 导航 到 android-studio/sdk/platform-tools 目录 ， 然 后 使 用 如 下 所 示 的 命令 : 
adb -d forward tcp:5601 tcp:5601 
如 果 由 于 某 种 原因 ， 仍 然 无 法 连接 两 个 设备 ， 尝 试 使 用 adb devices， 可 以 使 用 上 述 命令 在 每 当 将 
手机 连接 到 电脑 或 每 次 重新 启动 时 使 用 的 仿真 器 。 其 中 未 连接 时 的 界面 如 图 17-26 所 示 。 已 经 连接 后 
的 界面 如 图 17-27 所 示 。 


[en 5554-AndroidWearRound 


өп 5554 AncroidWearRound 


图 17-26 未 连接 时 的 界面 图 17-27 连接 后 的 界面 
(4) f£ Eclipse 中 新 建 一 个 Android 应 用 程序 ， 如 图 17-28 所 示 。 


ө 


^0 Create New Project 


Add information to your new project 


图 17-28 新 建 一 个 Android 项 目 


G) 为 了 提高 应 用 程序 的 运行 速度 ， 建 议 使 用 较 低 版 本 的 SDK， 例 如 Android 4.0.3, Ed 17-29 
所 示 。 

(6) 在 Add an activity to Mobile 界面 中 选择 Blank Activity 选项 ， 如 图 17-30 所 示 。 

CD 在 工程 中 添加 需要 的 库 文 件 : wearable-preview-supportjar、gradle-wrapperjar， 如 图 17-31 所 示 。 
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eoo Create New Project 


Select the form factor(s) your app will run on 


Different platforms requi 


17-29 ”使 用 较 低 版 本 的 SDK 


eco Create New Project 


Add an activity to Mobile 


El iS MainActivity 

Ë mj Android 4.0 

9-84 Android Dependencies 

lo annotations~f£e517115e60ae5385e883be78 £17024, jar 
sre 

8-28 gen [Generated Java Files] 
Ë nyawesomepackagename. codelabandroi dvear 
BA Android Private Libraries 
D assets 

8-05 bin 

由 - 它 java 

8-05 res 
3, Androi dani fest. xml 
B, ic photo-web. png 
国 project. properties 


图 17-30 选择 Blank Activity 选项 图 17-31 添加 需要 的 库 文件 
(8) 编写 依赖 文件 build.gradle， 具 体 实现 代码 如 下 : 
dependencies { 
compile 'com.android.support:support-v4:19.1.+' /支持 的 类 库 
compile fileTree(dir: 'libs', include: ['* jar']) /| 编译 目录 中 的 所 有 .jar 库 文件 


} 
(9) 开始 为 Android 应 用 程序 创建 一 个 通知 图 标 ， 在 res 文件 夹 上 右 击 ， 并 在 弹出 的 快捷 菜单 中 


依次 选择 New | Image Asset 命令 ， 如 图 17-32 所 示 。 
(10) 在 弹出 界面 的 Asset Type 下 拉 列 表 中 选择 Notification Icons， 并 给 它 命名 一 个 资源 名 称 ， 如 
图 17-33 所 示 。 
(11) 检查 设置 的 姓名 和 目标 是 否 正确 ， 并 单 击 Finish GEk) 按钮 ，Android 将 为 Notification A 
动 生成 所 有 需要 尺寸 的 图 标 和 文件 夹 ， 如 图 17-34 所 示 。 
è 
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图 17-32 选择 New | Image Asset 命令 


set Studion 


图 17-33 命名 资源 名 称 
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标 和 文件 夹 
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(12) 创建 主 XML 布局 文件 activity_main.xml， 具 体 实现 代码 如 下 : 
<LinearLayout 
xmins:android="http://schemas.android.com/apk/res/android" 
xmins:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:paddingLeft-"(Qdimen/activity horizontal margin" 
android:paddingRight-"(Qdimen/activity horizontal margin" 
android:paddingTop-"(gdimen/activity vertical margin" 
tools:context=".MainActivity" 
android:orientation="vertical" 
android:background="#34495e" 
> 
<Button 
android:id="@+id/simpleNotification" 
android:text="Simple Notification" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginBottom-"(Qdimen/activity vertical margin" 
android:onClick-"sendNotification" 
> 
<Button 
android:id="@+id/bigNotification" 
android:text="Big View Notification" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginBottom-"(Qdimen/activity vertical margin" 
android:onClick-"sendNotification" 
> 
<Button 
android:id="@+id/bigNotificationWithAction" 
android:text="Big Notification With Action" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginBottom-"(gdimen/activity vertical margin" 
android:onClick-"sendNotification" 
> 
<TextView 
android:text="Custom Notification" 
android:textAppearance="?android:attr/textAppearanceLarge" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:layout marginBottom-"(gdimen/activity vertical margin" 
> 
<EditText 
android:id="@+id/notificationTitle” 
android:hint="Notification Title" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginBottom-"(gdimen/activity vertical margin" 
> 
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@ 


<EditText 


android:id="@+id/notificationMessage" 

android:hint="Notification Message" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_marginBottom="@dimen/activity_vertical_margin" 


> 
<RadioGroup 
android:id="@+id/iconGroup" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
android:layout marginBottom-"(Qdimen/activity vertical margin" 
<RadioButton 
android:id="@+id/icon1" 
android:drawableRight="@drawable/ic_wear_notification" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginRight-"(odimen/activity horizontal margin" 
> 
<RadioButton 
android:id="@+id/icon2" 
android:drawableRight="@drawable/ic_notification_2" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:layout marginRight-"(dimen/activity horizontal margin" 
> 
<RadioButton 
android:id="@+id/icon3" 
android:drawableRight="@drawable/ic_notification3" 
android:layout_width="Wrap_content" 
android:layout height-"wrap content" 
android:layout marginRight-"(dimen/activity horizontal margin" 
> 
</RadioGroup> 
<RadioGroup 


android:id="@+id/hidelconGroup" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
android:layout marginBottom-"(gdimen/activity vertical margin" 
> 
<RadioButton 
android:id="@+id/hidelcon" 
android:text="Hide Icon" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout marginRight-"(dimen/activity horizontal margin" 
> 
<RadioButton 
android:id="@+id/showlcon" 
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android:text="Show Icon" 
android:layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout marginRight-"(dimen/activity horizontal margin" 
> 
</RadioGroup> 
<Button 
android:id="@+id/sendCustomNotification" 
android:text="Send Custom Notification" 
android:layout_width="match_parent" 
android:layout height-"wrap content" 
android:onClick-"sendNotification" 
I 
</LinearLayout> 


上 述 布局 文件 的 执行 效果 如 图 17-35 所 示 。 


图 17-35 主 界面 执行 效果 


(13) 通过 使 用 Android 穿戴 API, 可 以 将 手机 通知 信息 发 送 到 穿戴 设备 中 。 接 下 来 首先 为 主 界面 
的 android:onClick="sendNotification" 按 钮 添加 单 击 响 应 事件 处 理 程序 ， 具 体 实现 代码 如 下 : 
public void sendNotification(View view) { 
Switch(view.getld()) { 
case R.id.simpleNotification: 
break; 


case R.id.bigNotification: 
break; 


case R.id.bigNotificationWithAction: 
break; 


case R.id.sendCustomNotification: 
break; 
) 
} 


(14) 将 如 下 所 示 的 实例 变量 添加 到 类 ， 这 些 实例 变量 和 RadioGroup 中 输入 的 数据 相对 应 。 
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public class MainActivity extends Activity í 


private EditText mCustomTitle, mCustomMessage; 

private RadioGroup mCustomlconGroup, showHidelconGroup; 
private int mCustomlcon; 

private boolean showlcon = false; 

private String LOG_TAG = "WEAR"; 


@Override 
(15) 实例 化 用 户 界面 元 素 ， 并 添加 检索 有 关 哪 个 元 素 被 选中 的 信息 。 具 体 实 现代 码 如 下 : 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity main); 


mCustomTitle = (EditText) findViewByld(R.id.notificationTitle); 
mCustomMessage = (EditText) findViewByld(R.id.notificationMessage); 


mCustomlconGroup = (RadioGroup) findViewByld(R.id.iconGroup); 
mCustomlconGroup.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() { 
@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) { 
switch (group.getCheckedRadioButtonld()) { 
case R.id.icon1: 
mCustomlcon = R.drawable.ic_wear_notification; 
break; 
case R.id.icon2: 
mCustomicon = R.drawable.ic notification 2; 
break; 
case R.id.icon3: 
mCustomlcon = R.drawable.ic notification3; 
break; 


) 
) 


showHidelconGroup = (RadioGroup) findViewByld(R.id.hidelconGroup); 
showHidelconGroup.setOnCheckedChangeListener(new RadioGroup.OnCheckedChangeListener() ( 
@Override 
public void onCheckedChanged(RadioGroup group, int checkedld) { 
switch (group.getCheckedRadioButtonld()) { 
case R.id.showlcon: 
showlcon = true; 
break; 
case R.id.hidelcon: 
showlcon = false; 
break; 


) 
i }: 
(16) 编写 发 送 通知 信息 的 方法 sendNotificationO, 在 切换 之 前 添加 所 有 的 变量 信息 以 便 在 通知 之 
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间 实 现 共享 。 具体 实现 代码 如 下 : 


public void sendNotification(View view) { 


int notificationld = 001; //id- An identifier for this notification unique within your application. 

String eventTitle = "Sample Notification"; //Title for the notificaiton 

String eventText = "Text for the notification."; //Text for the notificaiton 

String intentExtra = "This is an extra String!"; //Extra String to be passed to a intent 

String eventDescription = "This is supposed to be a content that will not fit the normal content screen" 
+" usually a bigger text, by example a long text message or email."; 


Intent viewIntent = new Intent(this, MainActivity.class); 
PendinglIntent viewPendinglIntent = Pendinglntent.getActivity(this, 0, viewIntent, 0); 


NotificationCompat.BigTextStyle bigStyle = new NotificationCompat.BigTextStyle(); 


NotificationCompat.Builder mBuilder = null; 
Notification mNotification = null; 


NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this); 


Switch(view.getld()) { 
case R.id.simpleNotification: 
break; 


case R.id.bigNotification: 
break; 


case R.id.bigNotificationWithAction: 
break; 


case R.id.sendCustomNotification: 
break; 
} 
} 
(17) 开始 构建 声明 ， 根 据 用 户 的 输入 来 显示 通知 信息 。 可 以 使 用 Notification 建立 和 发 送 通知 任 
何 元 素 对 象 ， 如 游戏 得 分 、 闹 钟 等 。 
М 简单 通知 。 
实现 一 个 简单 的 用 4 个 元 素 通 知 的 形式 。 第 一 个 是 可 绘制 的 通知 ， 使 用 资产 管理 器 创建 可 绘制 对 
象 之 一 。 第 二 个 用 一 个 标题 通知 3， 要 显示 4 的 消息 。 有 具体 实现 代码 如 下 
case R.id.simpleNotification: 
mBuilder = new NotificationCompat.Builder(this) 
.setSmalliIcon(R.drawable.ic wear notification) 
.setContentTitle(eventTitle) 
.setContentText(eventText) 
.setAutoCancel(true) 
.setContentIntent(viewPendinglntent); 
break; 
在 开关 后 添加 下 面 的 代码 来 显示 或 通知 。 
notificationManager.notify(notificationld, mBuilder.build()); 
Log.d(LOG TAG, "Normal Notification"); 
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此 时 开始 测试 ， 运 行 Android 应 用 程序 ， 在 手机 上 的 运行 效果 如 图 17-36 所 示 。 
此 时 通知 信息 在 可 穿戴 设备 中 的 运行 效果 如 图 17-37 所 示 。 


Sample Notification 
Text for the notification 


图 17-36 在 手机 上 的 运行 效果 图 17-37 在 可 穿戴 设备 中 的 运行 效果 


回 实现 大 图 标 通 知 效果 ， 大 图 标 作为 通知 信息 的 背景 显示 在 后 面 ， 不 同 的 小 图 标 将 使 用 
BitmapFactory.decodeResource0 解 码 PNG 文件 ， 此 时 该 setContentTitle 和 setContentText 将 由 
bigStyle.bigText 和 bigStyle.setBigContentTitle 覆盖 。 有 具体 实现 代码 如 下 : 

case R.id.bigNotification: 

bigStyle.bigText(eventDescription); 
bigStyle.setBigContentTitle("Override Title"); 
mBuilder = new NotificationCompat.Builder(this) 
-setSmalllcon(R.drawable.ic_wear_notification) 
.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic sample codelab)) 
.setContentTitle(eventTitle) 
.setContentText(eventText) 
.setContentIntent(viewPendingIntent) 
.setAutoCancel(true) 
.setStyle(bigStyle); 
break; 
大 图 标 通知 在 可 穿戴 设备 中 的 效果 如 图 17-38 所 示 ， 因 为 文本 被 设置 为 一 个 大 的 文本 ， 所 以 提供 
一 个 允许 用 户 向 内 侧 滚 动 以 阅读 完整 文字 。 
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Override Title - 


В 17-38 ”大 图 标 通知 
М ”为 了 实现 大 图 标 通知 功 能 ， 创 建 第 二 个 Activity 界面 ， 布 局 文件 activity second.xml 的 具体 实 
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现代 码 如 下 : 

<LinearLayout xmins:android="http://schemas.android.com/apk/res/android"” 
xmins:tools="http://schemas.android.com/tools" 
android:layout_width="match_parent" 
android:layout height-"match parent" 
android:paddingLeft-"(dimen/activity horizontal margin" 
android:paddingRight-"(Qdimen/activity horizontal margin" 
android:paddingTop-"(dimen/activity vertical margin" 
android:paddingBottom-"(g)dimen/activity vertical margin" 
android:background="#34495e" 
android:orientation="vertical" 
tools:context="myawesomepackagename.codelabandroidwear.SecondActivity"> 


<TextView 
android:id="@+id/extraMessage" 
android:text="@string/hello_world" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 


<ImageView 
android:id="@+id/extraPhoto" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
> 
</LinearLayout> 
M ТТ AE BACK — He BR, t PROCEDE 建立 Notificaiton 提醒 信息 。 实 例 
文件 SecondActivity.java 的 具体 实现 代码 如 下 : 
@Override 
protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedinstanceState); 
setContentView(R.layout.activity second); 
TextView mTextView = (TextView) findViewByld(R.id.extraMessage); 
ImageView mlmageView = (ImageView) findViewByld(R.id.extraPhoto); 
} 


Intent extralntent = getintent(); 


//Get the intent information based on the names passed by your notificaiton "message" and 
mTextView.setT ext(extralntent.getStringExtra("message")); 
mlmageView.setlmageResource(extralntent.getIntExtra("photo", 0)); 
case R.id.bigNotificationWithAction: 
Intent photolntent = new Intent(this, SecondActivity.class); 
photoIntent.putExtra("message", intentExtra); 
photoIntent.putExtra("photo", R.drawable.ic sample codelab); 


PendingIntent photoPending = Pendinglntent.getActivity(this, 0, photolntent, 0); 

bigStyle.setBigContentTitle("Mr. Flowers"); 

bigStyle.bigText("Check out this picture!! :D"); 

mBuilder = new NotificationCompat.Builder(this) 
-SetSmalllcon(R.drawable.ic_wear_notification) 
.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic sample codelab)) 
.setContentIntent(viewPendingIntent) 
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-addAction(R.drawable.ic_photo, "See Photo", photoPending) 
-setAutoCancel(true) 
.setStyle(bigStyle); 

break; 


此 时 可 以 在 手机 中 和 可 穿戴 设备 中 实现 大 图 标 通知 效果 ， 如 图 17-39 所 示 。 


SSS4-Moto360 


See Photo 


手机 中 的 信息 穿戴 设备 中 的 信息 
图 17-39 大 图 标 通知 信息 


至 此 ， 便 建立 了 手机 和 智能 手表 之 间 的 信息 通知 功能 。 读 者 可 以 继续 编写 其 他 类 型 的 通知 信息 ， 
例如 自 定义 一 个 : 让 用 户 设置 标题 、 一 条 消息 ， 并 选择 图 标 在 通知 中 显示 ， 如 果 用 户 想 要 显示 或 没有 
应 用 程序 图 标 会 给 出 一 个 选项 。 上 述 功能 的 实现 代码 如 下 : 

case R.id.sendCustomNotification: 

mBuilder = new NotificationCompat.Builder(this) 
.setSmallicon(mCustomlcon) 
.setContentTitle(mCustomTitle.getText().toString()) 
.setAutoCancel(true) 
.setContentText(mCustomMessage.getText().toString()) 
.setContentIntent(viewPendingIntent); 


mNotification = new WearableNotifications.Builder(mBuilder) 
.setHintHidelcon(Ishowlcon) 
.build(); 
break; 
另外 还 有 另 一 种 类 型 的 通知 ， 以 显示 需要 的 情况 下 加 入 到 电话 通知 功能 中 。 在 开关 后 替换 已 经 存 
在 的 代码 ， 具 体 实现 代码 如 下 : 
if(view.getld() != R.id.sendCustomNotification) { 
notificationManager.notify(notificationld, mBuilder.build()); 
Log.d(LOG_TAG, "Normal Notification"); 
) else { 
notificationManager.notify(notificationld, mNotification); 
Log.d(LOG_TAG, "Wear Notification"); 
} 
读者 可 以 书 中 的 实例 为 基础 ， 继 续 自 由 发 挥 自己 的 创作 天 赋 。 
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